@prisma/compute-sdk 0.29.0 → 0.30.0

package/src/errors.ts

@@ -37,57 +37,61 @@ export class ArtifactError extends TaggedError("ArtifactError")<{
 }>() {}
 
 export class TimeoutError extends TaggedError("TimeoutError")<{
-  versionId: string;
+  deploymentId: string;
   elapsedMs: number;
   lastStatus: string;
   message: string;
 }>() {
   constructor(args: {
-    versionId: string;
+    deploymentId: string;
     elapsedMs: number;
     lastStatus: string;
   }) {
     super({
       ...args,
-      message: `Timed out waiting for version ${args.versionId} to reach target state (last status: ${args.lastStatus}, elapsed: ${Math.round(args.elapsedMs / 1000)}s)`,
+      message: `Timed out waiting for deployment ${args.deploymentId} to reach target state (last status: ${args.lastStatus}, elapsed: ${Math.round(args.elapsedMs / 1000)}s)`,
     });
   }
 }
 
-export class VersionFailedError extends TaggedError("VersionFailedError")<{
-  versionId: string;
+export class DeploymentFailedError extends TaggedError(
+  "DeploymentFailedError",
+)<{
+  deploymentId: string;
   message: string;
 }>() {
-  constructor(args: { versionId: string }) {
+  constructor(args: { deploymentId: string }) {
     super({
-      versionId: args.versionId,
-      message: `Version ${args.versionId} transitioned to failed status`,
+      deploymentId: args.deploymentId,
+      message: `Deployment ${args.deploymentId} transitioned to failed status`,
     });
   }
 }
 
-export class NoExistingVersionError extends TaggedError(
-  "NoExistingVersionError",
+export class NoExistingDeploymentError extends TaggedError(
+  "NoExistingDeploymentError",
 )<{
-  serviceId: string;
+  appId: string;
   message: string;
 }>() {
-  constructor(args: { serviceId: string }) {
+  constructor(args: { appId: string }) {
     super({
-      serviceId: args.serviceId,
-      message: `Service ${args.serviceId} has no existing versions. Environment-only updates require at least one prior deployment.`,
+      appId: args.appId,
+      message: `App ${args.appId} has no existing deployments. Environment-only updates require at least one prior deployment.`,
     });
   }
 }
 
-export class NoVersionsFoundError extends TaggedError("NoVersionsFoundError")<{
-  serviceId: string;
+export class NoDeploymentsFoundError extends TaggedError(
+  "NoDeploymentsFoundError",
+)<{
+  appId: string;
   message: string;
 }>() {
-  constructor(args: { serviceId: string }) {
+  constructor(args: { appId: string }) {
     super({
-      serviceId: args.serviceId,
-      message: `Service ${args.serviceId} has no versions`,
+      appId: args.appId,
+      message: `App ${args.appId} has no deployments`,
     });
   }
 }
@@ -104,19 +108,19 @@ export class DestroyAggregateError extends TaggedError(
   "DestroyAggregateError",
 )<{
   message: string;
-  succeededVersionIds: string[];
-  failures: Array<{ versionId: string; error: VersionOperationError }>;
-  serviceDeleted: boolean;
+  succeededDeploymentIds: string[];
+  failures: Array<{ deploymentId: string; error: DeploymentOperationError }>;
+  appDeleted: boolean;
 }>() {
   constructor(args: {
-    succeededVersionIds: string[];
-    failures: Array<{ versionId: string; error: VersionOperationError }>;
-    serviceDeleted: boolean;
+    succeededDeploymentIds: string[];
+    failures: Array<{ deploymentId: string; error: DeploymentOperationError }>;
+    appDeleted: boolean;
   }) {
-    const failedIds = args.failures.map((f) => f.versionId).join(", ");
+    const failedIds = args.failures.map((f) => f.deploymentId).join(", ");
     super({
       ...args,
-      message: `Failed to destroy ${args.failures.length} version(s): ${failedIds}`,
+      message: `Failed to destroy ${args.failures.length} deployment(s): ${failedIds}`,
     });
   }
 }
@@ -138,7 +142,7 @@ export type DeployError =
   | BuildError
   | ArtifactError
   | TimeoutError
-  | VersionFailedError
+  | DeploymentFailedError
   | CancelledError;
 
 export type UpdateEnvError =
@@ -146,21 +150,21 @@ export type UpdateEnvError =
   | ApiError
   | MissingArgumentError
   | InvalidOptionsError
-  | NoExistingVersionError
+  | NoExistingDeploymentError
   | TimeoutError
-  | VersionFailedError
+  | DeploymentFailedError
   | CancelledError;
 
-export type DestroyVersionError =
+export type DestroyDeploymentError =
   | CancelledError
   | MissingArgumentError
-  | NoVersionsFoundError
+  | NoDeploymentsFoundError
   | AuthenticationError
   | ApiError
   | TimeoutError
-  | VersionFailedError;
+  | DeploymentFailedError;
 
-export type DestroyServiceError =
+export type DestroyAppError =
   | CancelledError
   | AuthenticationError
   | ApiError
@@ -170,16 +174,16 @@ export type PromoteError =
   | AuthenticationError
   | ApiError
   | MissingArgumentError
-  | NoVersionsFoundError
+  | NoDeploymentsFoundError
   | TimeoutError
-  | VersionFailedError
+  | DeploymentFailedError
   | CancelledError;
 
 export type ApiRequestError = CancelledError | AuthenticationError | ApiError;
 
-export type VersionOperationError =
+export type DeploymentOperationError =
   | CancelledError
   | AuthenticationError
   | ApiError
   | TimeoutError
-  | VersionFailedError;
+  | DeploymentFailedError;

package/src/index.ts

@@ -40,32 +40,32 @@ 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";
@@ -83,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,
@@ -95,14 +95,14 @@ export {
   AuthenticationError,
   BuildError,
   CancelledError,
+  DeploymentFailedError,
   DestroyAggregateError,
   InvalidOptionsError,
   LogStreamError,
   MissingArgumentError,
-  NoExistingVersionError,
-  NoVersionsFoundError,
+  NoDeploymentsFoundError,
+  NoExistingDeploymentError,
   TimeoutError,
-  VersionFailedError,
 } from "./errors.ts";
 export type {
   LogRecord,
@@ -118,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/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/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;
 }