@prisma/compute-sdk 0.28.0 → 0.30.0

package/src/index.ts

@@ -40,36 +40,37 @@ export { BunBuild } from "./bun-build.ts";
 export type {
   DeployInteraction,
   DeployProgress,
-  DestroyServiceProgress,
-  DestroyVersionInteraction,
-  DestroyVersionProgress,
+  DestroyAppProgress,
+  DestroyDeploymentInteraction,
+  DestroyDeploymentProgress,
   PromoteProgress,
   UpdateEnvProgress,
 } from "./callbacks.ts";
 export type {
+  CreateAppOptions,
   CreateProjectOptions,
-  CreateServiceOptions,
-  DeleteServiceOptions,
-  DeleteVersionOptions,
+  DeleteAppOptions,
+  DeleteDeploymentOptions,
   DeployOptions,
   DeployResult,
-  DestroyServiceOptions,
-  DestroyServiceResult,
-  DestroyVersionOptions,
-  DestroyVersionResult,
+  DestroyAppOptions,
+  DestroyAppResult,
+  DestroyDeploymentOptions,
+  DestroyDeploymentResult,
+  ListAppsOptions,
+  ListDeploymentsOptions,
   ListProjectsOptions,
-  ListServicesOptions,
-  ListVersionsOptions,
   PromoteOptions,
   PromoteResult,
-  ShowServiceOptions,
-  ShowVersionOptions,
-  StartVersionOptions,
-  StopVersionOptions,
+  ShowAppOptions,
+  ShowDeploymentOptions,
+  StartDeploymentOptions,
+  StopDeploymentOptions,
   UpdateEnvOptions,
   UpdateEnvResult,
 } from "./compute-client.ts";
 export { ComputeClient } from "./compute-client.ts";
+export { CustomBuild } from "./custom-build.ts";
 export type {
   DetectedSchema,
   MigrationCommand,
@@ -82,11 +83,11 @@ export { detectAppSchema } from "./detect-schema.ts";
 export type {
   ApiRequestError,
   DeployError,
-  DestroyServiceError,
-  DestroyVersionError,
+  DeploymentOperationError,
+  DestroyAppError,
+  DestroyDeploymentError,
   PromoteError,
   UpdateEnvError,
-  VersionOperationError,
 } from "./errors.ts";
 export {
   ApiError,
@@ -94,14 +95,14 @@ export {
   AuthenticationError,
   BuildError,
   CancelledError,
+  DeploymentFailedError,
   DestroyAggregateError,
   InvalidOptionsError,
   LogStreamError,
   MissingArgumentError,
-  NoExistingVersionError,
-  NoVersionsFoundError,
+  NoDeploymentsFoundError,
+  NoExistingDeploymentError,
   TimeoutError,
-  VersionFailedError,
 } from "./errors.ts";
 export type {
   LogRecord,
@@ -117,16 +118,16 @@ export { NextjsBuild } from "./nextjs-build.ts";
 export { NuxtBuild } from "./nuxt-build.ts";
 export { TanstackStartBuild } from "./tanstack-start-build.ts";
 export type {
+  AppDetail,
+  AppInfo,
   CreateProjectResult,
   DatabaseInfo,
+  DeploymentDetail,
+  DeploymentInfo,
   PortMapping,
   ProjectInfo,
   RegionInfo,
   ResolvedConfig,
-  ServiceDetail,
-  ServiceInfo,
-  VersionDetail,
-  VersionInfo,
 } from "./types.ts";
 export { KNOWN_REGION_IDS, REGIONS } from "./types.ts";
 export { uploadArtifact } from "./upload-artifact.ts";

package/src/log-stream.ts

@@ -27,7 +27,7 @@ export type StreamRecord = LogRecord | TerminalRecord;
 export type LogStreamOptions = {
   baseUrl: string;
   token: string;
-  versionId: string;
+  deploymentId: string;
   tail?: number;
   fromStart?: boolean;
   cursor?: string;
@@ -71,7 +71,7 @@ function toError(value: unknown): Error {
 
 function buildWebSocketUrl(options: LogStreamOptions): string {
   const httpUrl = new URL(
-    `/v1/compute-services/versions/${encodeURIComponent(options.versionId)}/logs`,
+    `/v1/deployments/${encodeURIComponent(options.deploymentId)}/logs`,
     options.baseUrl,
   );
   httpUrl.protocol = httpUrl.protocol === "https:" ? "wss:" : "ws:";

package/src/nestjs-build.ts

@@ -24,15 +24,11 @@ import type { BuildArtifact, BuildStrategy } from "./build-strategy.ts";
 import {
   hasPackageDependency,
   hasRootFile,
-  runPackageCli,
+  runBuildSettingsCommand,
 } from "./build-strategy.ts";
 import { defaultHttpPortForBuildType } from "./config/frameworks.ts";
 import { resolveSourceRoot } from "./config/source-root.ts";
-import {
-  type BuildCommandIo,
-  readPackageManifest,
-  runBuildCommand,
-} from "./workspace.ts";
+import { type BuildCommandIo, readPackageManifest } from "./workspace.ts";
 
 const NEST_CLI_FILENAME = "nest-cli.json";
 
@@ -81,37 +77,26 @@ export class NestjsBuild implements BuildStrategy {
         signal,
       }));
 
-    // `resolveBuildSettings` always returns a non-null `nest build` fallback, so
-    // route by source: a user `build` script runs as-is, the framework default
-    // goes through the launcher ladder (local bin -> npx -> bunx).
-    const usingFrameworkDefault =
-      settings.buildCommand === null ||
-      settings.buildCommandSource === "NestJS default";
-    if (!usingFrameworkDefault && settings.buildCommand) {
-      await runBuildCommand({
-        appPath: this.#appPath,
-        command: settings.buildCommand,
-        failurePrefix: "NestJS",
-        env: this.#io?.env,
-        onOutput: this.#io?.onOutput,
-        signal,
-      });
-    } else {
-      await runPackageCli({
-        appPath: this.#appPath,
+    await runBuildSettingsCommand({
+      appPath: this.#appPath,
+      settings,
+      failurePrefix: "NestJS",
+      defaultCli: {
+        source: "NestJS default",
         cliName: "nest",
         args: ["build"],
-        failurePrefix: "NestJS",
         missingMessage:
           "Could not find the Nest CLI. Add a `build` script to package.json, install @nestjs/cli, or ensure npx/bunx is available.",
-        env: this.#io?.env,
-        onOutput: this.#io?.onOutput,
-        signal,
-      });
-    }
+      },
+      io: this.#io,
+      signal,
+    });
 
     signal?.throwIfAborted();
-    const compiledEntry = await this.#resolveCompiledEntrypoint(signal);
+    const compiledEntry = await this.#resolveCompiledEntrypoint(
+      settings,
+      signal,
+    );
 
     const outDir = await mkdtemp(path.join(os.tmpdir(), "compute-build-"));
     try {
@@ -140,9 +125,16 @@ export class NestjsBuild implements BuildStrategy {
    * separators. Prefers `package.json` `main`, then the path computed from
    * `nest-cli.json` and the tsconfig `outDir`, then the common defaults.
    */
-  async #resolveCompiledEntrypoint(signal?: AbortSignal): Promise<string> {
+  async #resolveCompiledEntrypoint(
+    settings: BuildSettings,
+    signal?: AbortSignal,
+  ): Promise<string> {
     const candidates: string[] = [];
 
+    if (settings.entrypoint) {
+      candidates.push(joinPosix(settings.outputDirectory, settings.entrypoint));
+    }
+
     const fromMain = await this.#mainFieldEntrypoint(signal);
     if (fromMain) {
       candidates.push(fromMain);
@@ -153,7 +145,7 @@ export class NestjsBuild implements BuildStrategy {
       candidates.push(fromConfig);
     }
 
-    candidates.push(...DEFAULT_COMPILED_ENTRYPOINTS);
+    candidates.push(...compiledEntrypointDefaults(settings.outputDirectory));
 
     for (const candidate of candidates) {
       signal?.throwIfAborted();
@@ -195,6 +187,17 @@ export class NestjsBuild implements BuildStrategy {
   }
 }
 
+function compiledEntrypointDefaults(outputDirectory: string): string[] {
+  if (outputDirectory === "dist") {
+    return DEFAULT_COMPILED_ENTRYPOINTS;
+  }
+  return [
+    joinPosix(outputDirectory, "src/main.js"),
+    joinPosix(outputDirectory, "main.js"),
+    ...DEFAULT_COMPILED_ENTRYPOINTS,
+  ];
+}
+
 interface NestCliConfig {
   sourceRoot?: string;
   entryFile?: string;

package/src/nextjs-build.ts

@@ -9,9 +9,14 @@ import {
   resolveBuildSettings,
 } from "./build-settings.ts";
 import type { BuildArtifact, BuildStrategy } from "./build-strategy.ts";
-import { hasPackageDependency, hasRootFile } from "./build-strategy.ts";
+import {
+  hasPackageDependency,
+  hasRootFile,
+  runBuildSettingsCommand,
+} from "./build-strategy.ts";
 import { defaultHttpPortForBuildType } from "./config/frameworks.ts";
-import { type BuildCommandIo, runBuildCommand } from "./workspace.ts";
+import { resolveConfiguredArtifactEntrypoint } from "./configured-artifact.ts";
+import type { BuildCommandIo } from "./workspace.ts";
 
 const NEXT_CONFIG_FILENAMES = [
   "next.config.js",
@@ -63,20 +68,24 @@ export class NextjsBuild implements BuildStrategy {
         buildType: "nextjs",
         signal,
       }));
-    if (settings.buildCommand) {
-      await runBuildCommand({
-        appPath: this.#appPath,
-        command: settings.buildCommand,
-        failurePrefix: "Next.js",
-        env: this.#io?.env,
-        onOutput: this.#io?.onOutput,
-        signal,
-      });
-    }
+    await runBuildSettingsCommand({
+      appPath: this.#appPath,
+      settings,
+      failurePrefix: "Next.js",
+      defaultCli: {
+        source: "Next.js default",
+        cliName: "next",
+        args: ["build"],
+        missingMessage:
+          "Could not find the Next.js CLI. Install it with `npm install next` or ensure npx/bunx is available.",
+      },
+      io: this.#io,
+      signal,
+    });
 
     const standaloneDir = path.join(this.#appPath, settings.outputDirectory);
     if (!(await directoryExists(standaloneDir))) {
-      if (this.#requireStandalone) {
+      if (this.#requireStandalone || settings.entrypoint) {
         throw new Error(
           `Next.js build did not produce standalone output at ${settings.outputDirectory}. ` +
             'Set output: "standalone" in your next.config; this deploy target requires it.',
@@ -97,7 +106,15 @@ export class NextjsBuild implements BuildStrategy {
         appPath: this.#appPath,
         signal,
       });
-      const entrypoint = await findStandaloneEntrypoint(artifactDir);
+      const entrypoint = settings.entrypoint
+        ? await resolveConfiguredArtifactEntrypoint({
+            directory: artifactDir,
+            entrypoint: settings.entrypoint,
+            label: "Next.js",
+            displayDirectory: settings.outputDirectory,
+            missingEntrypointMessage: `Next.js standalone output did not contain configured entrypoint ${settings.outputDirectory}/${settings.entrypoint}.`,
+          })
+        : await findStandaloneEntrypoint(artifactDir);
       await copyStaticAssets({
         appPath: this.#appPath,
         artifactDir,

package/src/nuxt-build.ts

@@ -1,15 +1,11 @@
-import { cp, mkdtemp, rm, stat } from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-
-import { normalizeArtifactSymlinks } from "./artifact-postprocess.ts";
+import { type BuildSettings, resolveBuildSettings } from "./build-settings.ts";
 import type { BuildArtifact, BuildStrategy } from "./build-strategy.ts";
 import {
   hasPackageDependency,
   hasRootFile,
-  runPackageCli,
+  runBuildSettingsCommand,
 } from "./build-strategy.ts";
-import { defaultHttpPortForBuildType } from "./config/frameworks.ts";
+import { stageConfiguredArtifact } from "./configured-artifact.ts";
 import type { BuildCommandIo } from "./workspace.ts";
 
 const NUXT_CONFIG_FILENAMES = [
@@ -26,10 +22,16 @@ const NUXT_CONFIG_FILENAMES = [
  */
 export class NuxtBuild implements BuildStrategy {
   readonly #appPath: string;
+  readonly #buildSettings?: BuildSettings;
   readonly #io?: BuildCommandIo;
 
-  constructor(options: { appPath: string; io?: BuildCommandIo }) {
+  constructor(options: {
+    appPath: string;
+    buildSettings?: BuildSettings;
+    io?: BuildCommandIo;
+  }) {
     this.#appPath = options.appPath;
+    this.#buildSettings = options.buildSettings;
     this.#io = options.io;
   }
 
@@ -42,48 +44,39 @@ export class NuxtBuild implements BuildStrategy {
 
   async execute(signal?: AbortSignal): Promise<BuildArtifact> {
     signal?.throwIfAborted();
-    await runPackageCli({
+    const settings =
+      this.#buildSettings ??
+      (await resolveBuildSettings({
+        appPath: this.#appPath,
+        buildType: "nuxt",
+        signal,
+      }));
+
+    await runBuildSettingsCommand({
       appPath: this.#appPath,
-      cliName: "nuxt",
-      args: ["build"],
+      settings,
       failurePrefix: "Nuxt",
-      missingMessage:
-        "Could not find the Nuxt CLI. Install it with `npm install nuxt` or ensure npx/bunx is available.",
-      env: this.#io?.env,
-      onOutput: this.#io?.onOutput,
+      defaultCli: {
+        source: "Nuxt default",
+        cliName: "nuxt",
+        args: ["build"],
+        missingMessage:
+          "Could not find the Nuxt CLI. Install it with `npm install nuxt` or ensure npx/bunx is available.",
+      },
+      io: this.#io,
       signal,
     });
 
-    const outputDir = path.join(this.#appPath, ".output");
-    const entryPath = path.join(outputDir, "server", "index.mjs");
-    const entryStat = await stat(entryPath).catch(() => null);
-    if (!entryStat?.isFile()) {
-      throw new Error(
-        "Nuxt build did not produce a Nitro node server entrypoint at .output/server/index.mjs. Ensure nitro.preset is 'node-server' (the default) — set NITRO_PRESET=node-server or remove any custom preset from nuxt.config.",
-      );
-    }
-
-    const outDir = await mkdtemp(path.join(os.tmpdir(), "compute-build-"));
-
-    try {
-      const artifactDir = path.join(outDir, "app");
-      await cp(outputDir, artifactDir, {
-        recursive: true,
-        verbatimSymlinks: true,
-      });
-      // Materialize any symlinks into the app/workspace node_modules so the
-      // artifact is self-contained once unpacked elsewhere.
-      await normalizeArtifactSymlinks(artifactDir, this.#appPath, signal);
-
-      return {
-        directory: artifactDir,
-        entrypoint: "server/index.mjs",
-        defaultPortMapping: { http: defaultHttpPortForBuildType("nuxt") },
-        cleanup: () => rm(outDir, { recursive: true, force: true }),
-      };
-    } catch (error) {
-      await rm(outDir, { recursive: true, force: true });
-      throw error;
-    }
+    return stageConfiguredArtifact({
+      appPath: this.#appPath,
+      outputDirectory: settings.outputDirectory,
+      entrypoint: settings.entrypoint ?? "server/index.mjs",
+      buildType: "nuxt",
+      label: "Nuxt",
+      missingEntrypointMessage: settings.entrypoint
+        ? undefined
+        : `Nuxt build did not produce a Nitro node server entrypoint at ${settings.outputDirectory}/server/index.mjs. Ensure nitro.preset is 'node-server' (the default) - set NITRO_PRESET=node-server or remove any custom preset from nuxt.config.`,
+      signal,
+    });
   }
 }

package/src/polling.ts

@@ -3,8 +3,8 @@ import type { ApiClientError, InternalApiClient } from "./api-client.ts";
 import {
   ApiError,
   CancelledError,
+  DeploymentFailedError,
   TimeoutError,
-  VersionFailedError,
 } from "./errors.ts";
 
 export type PollOptions = {
@@ -23,17 +23,17 @@ export type PollResult = {
 export type PollError =
   | CancelledError
   | TimeoutError
-  | VersionFailedError
+  | DeploymentFailedError
   | ApiClientError;
 
 /**
- * Polls a compute version until it reaches the target status, fails, or times out.
+ * Polls a deployment until it reaches the target status, fails, or times out.
  *
  * Returns a Result with the preview domain on success or a typed error.
  */
-export async function pollVersionStatus(
+export async function pollDeploymentStatus(
   api: InternalApiClient,
-  versionId: string,
+  deploymentId: string,
   options: PollOptions,
 ): Promise<Result<PollResult, PollError>> {
   return Result.gen(async function* () {
@@ -45,34 +45,35 @@ export async function pollVersionStatus(
         return Result.err(new CancelledError());
       }
 
-      const version = yield* Result.await(
-        api.getVersion(versionId, options.signal),
+      const deployment = yield* Result.await(
+        api.getDeployment(deploymentId, options.signal),
       );
 
-      if (version.status !== lastStatus) {
-        lastStatus = version.status;
-        options.onStatusChange?.(version.status);
+      if (deployment.status !== lastStatus) {
+        lastStatus = deployment.status;
+        options.onStatusChange?.(deployment.status);
       }
 
-      if (version.status === options.targetStatus) {
-        if (options.targetStatus === "running" && !version.previewDomain) {
+      if (deployment.status === options.targetStatus) {
+        if (options.targetStatus === "running" && !deployment.previewDomain) {
           return Result.err(
             new ApiError({
               statusCode: 0,
               statusText: "",
-              message: "Version reached running state without a previewDomain",
+              message:
+                "Deployment reached running state without a previewDomain",
               traceHeaders: {},
             }),
           );
         }
         return Result.ok({
-          previewDomain: version.previewDomain ?? "",
-          lastStatus: version.status,
+          previewDomain: deployment.previewDomain ?? "",
+          lastStatus: deployment.status,
         });
       }
 
-      if (version.status === "failed") {
-        return Result.err(new VersionFailedError({ versionId }));
+      if (deployment.status === "failed") {
+        return Result.err(new DeploymentFailedError({ deploymentId }));
       }
 
       await sleep(options.pollIntervalMs, options.signal);
@@ -80,7 +81,7 @@ export async function pollVersionStatus(
 
     return Result.err(
       new TimeoutError({
-        versionId,
+        deploymentId,
         elapsedMs: Date.now() - (deadline - options.timeoutSeconds * 1_000),
         lastStatus,
       }),

package/src/tanstack-start-build.ts

@@ -1,13 +1,11 @@
-import { cp, mkdtemp, rm, stat } from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-
-import { normalizeArtifactSymlinks } from "./artifact-postprocess.ts";
 import { type BuildSettings, resolveBuildSettings } from "./build-settings.ts";
 import type { BuildArtifact, BuildStrategy } from "./build-strategy.ts";
-import { hasPackageDependency } from "./build-strategy.ts";
-import { defaultHttpPortForBuildType } from "./config/frameworks.ts";
-import { type BuildCommandIo, runBuildCommand } from "./workspace.ts";
+import {
+  hasPackageDependency,
+  runBuildSettingsCommand,
+} from "./build-strategy.ts";
+import { stageConfiguredArtifact } from "./configured-artifact.ts";
+import type { BuildCommandIo } from "./workspace.ts";
 
 const TANSTACK_START_PACKAGES = [
   "@tanstack/react-start",
@@ -47,51 +45,31 @@ export class TanstackStartBuild implements BuildStrategy {
         buildType: "tanstack-start",
         signal,
       }));
-    if (settings.buildCommand) {
-      await runBuildCommand({
-        appPath: this.#appPath,
-        command: settings.buildCommand,
-        failurePrefix: "TanStack Start",
-        env: this.#io?.env,
-        onOutput: this.#io?.onOutput,
-        signal,
-      });
-    }
-
-    const outputDir = path.join(this.#appPath, settings.outputDirectory);
-    const entrypoint = "server/index.mjs";
-    const entryStat = await stat(path.join(outputDir, entrypoint)).catch(
-      () => null,
-    );
-    if (!entryStat?.isFile()) {
-      throw new Error(
-        `TanStack Start build did not produce a Nitro node server entrypoint at ${settings.outputDirectory}/${entrypoint}. ` +
-          "Ensure your vite.config includes the tanstackStart() and nitro() plugins with the default node preset.",
-      );
-    }
-
-    const outDir = await mkdtemp(path.join(os.tmpdir(), "compute-build-"));
-    try {
-      const artifactDir = path.join(outDir, "app");
-      await cp(outputDir, artifactDir, {
-        recursive: true,
-        verbatimSymlinks: true,
-      });
-      // Materialize any symlinks into the app/workspace node_modules so the
-      // artifact is self-contained once unpacked elsewhere.
-      await normalizeArtifactSymlinks(artifactDir, this.#appPath, signal);
+    await runBuildSettingsCommand({
+      appPath: this.#appPath,
+      settings,
+      failurePrefix: "TanStack Start",
+      defaultCli: {
+        source: "TanStack Start default",
+        cliName: "vite",
+        args: ["build"],
+        missingMessage:
+          "Could not find the Vite CLI. Install it with `npm install vite` or ensure npx/bunx is available.",
+      },
+      io: this.#io,
+      signal,
+    });
 
-      return {
-        directory: artifactDir,
-        entrypoint,
-        defaultPortMapping: {
-          http: defaultHttpPortForBuildType("tanstack-start"),
-        },
-        cleanup: () => rm(outDir, { recursive: true, force: true }),
-      };
-    } catch (error) {
-      await rm(outDir, { recursive: true, force: true });
-      throw error;
-    }
+    return stageConfiguredArtifact({
+      appPath: this.#appPath,
+      outputDirectory: settings.outputDirectory,
+      entrypoint: settings.entrypoint ?? "server/index.mjs",
+      buildType: "tanstack-start",
+      label: "TanStack Start",
+      missingEntrypointMessage: settings.entrypoint
+        ? undefined
+        : `TanStack Start build did not produce a Nitro node server entrypoint at ${settings.outputDirectory}/server/index.mjs. Ensure your vite.config includes the tanstackStart() and nitro() plugins with the default node preset.`,
+      signal,
+    });
   }
 }

package/src/types.ts

@@ -23,7 +23,7 @@ export interface CreateProjectResult extends ProjectInfo {
   database?: DatabaseInfo;
 }
 
-export interface ServiceInfo {
+export interface AppInfo {
   id: string;
   name: string;
   region: string;
@@ -31,19 +31,19 @@ export interface ServiceInfo {
   createdAt?: string;
 }
 
-export interface ServiceDetail extends ServiceInfo {
-  latestVersionId?: string | null;
-  serviceEndpointDomain?: string;
+export interface AppDetail extends AppInfo {
+  latestDeploymentId?: string | null;
+  appEndpointDomain?: string;
 }
 
-export interface VersionInfo {
+export interface DeploymentInfo {
   id: string;
   status: string;
   createdAt: string;
   previewDomain?: string | null;
 }
 
-export interface VersionDetail extends VersionInfo {
+export interface DeploymentDetail extends DeploymentInfo {
   envVars?: Record<string, string | null>;
   foundryVersionId?: string;
 }
@@ -55,8 +55,8 @@ export interface RegionInfo {
 
 export interface ResolvedConfig {
   projectId: string;
-  serviceId: string;
-  serviceName: string;
+  appId: string;
+  appName: string;
   region: string;
   portMapping?: PortMapping;
 }