@prisma/compute-sdk 0.21.0 → 0.23.0

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ;IACR,MAAM;IACN,OAAO;IACP,MAAM;IACN,gBAAgB;IAChB,KAAK;CACG,CAAC;AAiDX;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/errors.d.ts

@@ -114,7 +114,7 @@ declare const LogStreamError_base: import("better-result").TaggedErrorClass<"Log
 export declare class LogStreamError extends LogStreamError_base {
 }
 export type DeployError = AuthenticationError | ApiError | MissingArgumentError | InvalidOptionsError | BuildError | ArtifactError | TimeoutError | VersionFailedError | CancelledError;
-export type UpdateEnvError = AuthenticationError | ApiError | MissingArgumentError | NoExistingVersionError | TimeoutError | VersionFailedError | CancelledError;
+export type UpdateEnvError = AuthenticationError | ApiError | MissingArgumentError | InvalidOptionsError | NoExistingVersionError | TimeoutError | VersionFailedError | CancelledError;
 export type DestroyVersionError = CancelledError | MissingArgumentError | NoVersionsFoundError | AuthenticationError | ApiError | TimeoutError | VersionFailedError;
 export type DestroyServiceError = CancelledError | AuthenticationError | ApiError | DestroyAggregateError;
 export type PromoteError = AuthenticationError | ApiError | MissingArgumentError | NoVersionsFoundError | TimeoutError | VersionFailedError | CancelledError;

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma/compute-sdk",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "description": "TypeScript SDK for deploying and managing applications on Prisma Compute",
   "license": "Apache-2.0",
   "repository": "prisma/project-compute",
@@ -12,6 +12,13 @@
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
       }
+    },
+    "./config": {
+      "bun": "./src/config/index.ts",
+      "import": {
+        "types": "./dist/config/index.d.ts",
+        "default": "./dist/config/index.js"
+      }
     }
   },
   "main": "./dist/index.js",
@@ -33,10 +40,11 @@
     "better-result": "^2.7.0",
     "tar-stream": "^3.1.8",
     "tiny-invariant": "1.3.3",
-    "ws": "^8.20.0"
+    "ws": "^8.20.0",
+    "jiti": "^2.7.0"
   },
   "peerDependencies": {
-    "@prisma/management-api-sdk": ">=1.23.0"
+    "@prisma/management-api-sdk": ">=1.36.0"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/src/api-client.ts

@@ -95,6 +95,17 @@ export class InternalApiClient {
     ).then((r) => r.map((body) => body.data));
   }
 
+  async getBranch(branchId: string, signal?: AbortSignal) {
+    return this.#request(
+      this.#client.GET("/v1/branches/{branchId}", {
+        params: { path: { branchId } },
+        signal,
+      }),
+      "/v1/branches/{branchId}",
+      signal,
+    ).then((r) => r.map((body) => body.data));
+  }
+
   async deleteService(
     computeServiceId: string,
     signal?: AbortSignal,
@@ -215,6 +226,72 @@ export class InternalApiClient {
     ).then((r) => r.map((body) => body.data));
   }
 
+  async listEnvironmentVariables(
+    query: ListEnvironmentVariablesQuery,
+    signal?: AbortSignal,
+  ) {
+    return this.#requestPaginated(
+      (cursor) =>
+        this.#client.GET("/v1/environment-variables", {
+          params: {
+            query: cursor ? { ...query, cursor } : query,
+          },
+          signal,
+        }),
+      "/v1/environment-variables",
+      signal,
+    );
+  }
+
+  async createEnvironmentVariable(
+    body: CreateEnvironmentVariableBody,
+    signal?: AbortSignal,
+  ) {
+    signal?.throwIfAborted();
+    return this.#request(
+      this.#client.POST("/v1/environment-variables", {
+        body,
+        // Intentionally do not pass AbortSignal for mutating operations.
+        // Aborting transport can leave remote completion ambiguous.
+      }),
+      "/v1/environment-variables",
+      signal,
+    ).then((r) => r.map((body) => body.data));
+  }
+
+  async updateEnvironmentVariable(
+    envVarId: string,
+    body: UpdateEnvironmentVariableBody,
+    signal?: AbortSignal,
+  ) {
+    signal?.throwIfAborted();
+    return this.#request(
+      this.#client.PATCH("/v1/environment-variables/{envVarId}", {
+        params: { path: { envVarId } },
+        body,
+        // Intentionally do not pass AbortSignal for mutating operations.
+        // Aborting transport can leave remote completion ambiguous.
+      }),
+      "/v1/environment-variables/{envVarId}",
+      signal,
+    ).then((r) => r.map((body) => body.data));
+  }
+
+  async deleteEnvironmentVariable(
+    envVarId: string,
+    signal?: AbortSignal,
+  ): Promise<Result<void, ApiClientError>> {
+    signal?.throwIfAborted();
+    return this.#unwrapVoid(
+      this.#client.DELETE("/v1/environment-variables/{envVarId}", {
+        params: { path: { envVarId } },
+        // Intentionally do not pass AbortSignal for mutating operations.
+        // Aborting transport can leave remote completion ambiguous.
+      }),
+      signal,
+    );
+  }
+
   async #request<TData>(
     request: Promise<RequestResult<TData>>,
     endpoint: string,
@@ -322,6 +399,18 @@ export type PromoteServiceBody = NonNullable<
   paths["/v1/compute-services/{computeServiceId}/promote"]["post"]["requestBody"]
 >["content"]["application/json"];
 
+type ListEnvironmentVariablesQuery = NonNullable<
+  paths["/v1/environment-variables"]["get"]["parameters"]["query"]
+>;
+
+type CreateEnvironmentVariableBody = NonNullable<
+  paths["/v1/environment-variables"]["post"]["requestBody"]
+>["content"]["application/json"];
+
+type UpdateEnvironmentVariableBody = NonNullable<
+  paths["/v1/environment-variables/{envVarId}"]["patch"]["requestBody"]
+>["content"]["application/json"];
+
 const TRACE_HEADER_NAMES = [
   "x-request-id",
   "x-correlation-id",

package/src/compute-client.ts

@@ -285,13 +285,19 @@ export class ComputeClient {
             ? artifact.defaultPortMapping
             : undefined);
 
+        yield* Result.await(
+          self.#applyEnvVars(
+            target.projectId,
+            target.branchId,
+            options.envVars,
+            options.signal,
+          ),
+        );
+
         const createResponse = yield* Result.await(
           self.#api.createServiceVersion(
             target.serviceId,
-            {
-              envVars: options.envVars,
-              portMapping,
-            },
+            portMapping ? { portMapping } : {},
             options.signal,
           ),
         );
@@ -413,14 +419,25 @@ export class ComputeClient {
         );
       }
 
+      yield* self.#checkAborted(options.signal);
+      yield* Result.await(
+        self.#applyEnvVars(
+          target.projectId,
+          target.branchId,
+          options.envVars,
+          options.signal,
+        ),
+      );
+
       yield* self.#checkAborted(options.signal);
 
       const createResponse = yield* Result.await(
         self.#api.createServiceVersion(
           target.serviceId,
           {
-            envVars: options.envVars,
-            portMapping: options.portMapping,
+            ...(options.portMapping !== undefined
+              ? { portMapping: options.portMapping }
+              : {}),
             skipCodeUpload: true,
           },
           options.signal,
@@ -1180,9 +1197,14 @@ export class ComputeClient {
         serviceId: string;
         serviceName: string;
         region: string;
+        branchId: string | null;
         isNewService: boolean;
       },
-      MissingArgumentError | CancelledError | AuthenticationError | ApiError
+      | MissingArgumentError
+      | CancelledError
+      | AuthenticationError
+      | ApiError
+      | InvalidOptionsError
     >
   > {
     const self = this;
@@ -1191,15 +1213,27 @@ export class ComputeClient {
         const service = yield* Result.await(
           self.#api.getService(options.serviceId, options.signal),
         );
-        const projectId = options.projectId ?? service.projectId;
-        if (!projectId) {
+        if (!service.projectId) {
           return Result.err(new MissingArgumentError({ field: "projectId" }));
         }
+        const requestedProjectId = options.projectId?.replace(/^proj_/, "");
+        const serviceProjectId = service.projectId.replace(/^proj_/, "");
+        if (
+          requestedProjectId !== undefined &&
+          requestedProjectId !== serviceProjectId
+        ) {
+          return Result.err(
+            new InvalidOptionsError({
+              message: `Service ${service.id} belongs to project ${service.projectId}, but project ${options.projectId} was provided`,
+            }),
+          );
+        }
         return Result.ok({
-          projectId,
+          projectId: service.projectId,
           serviceId: service.id,
           serviceName: service.name ?? service.id,
           region: service.region.id,
+          branchId: service.branchId ?? null,
           isNewService: false,
         });
       }
@@ -1240,6 +1274,7 @@ export class ComputeClient {
           serviceId: response.id,
           serviceName: response.name,
           region: response.region.id,
+          branchId: response.branchId ?? null,
           isNewService: true,
         });
       }
@@ -1264,13 +1299,20 @@ export class ComputeClient {
         await options.interaction.selectService(serviceInfos);
 
       if (selectedServiceId !== null) {
-        const service = services.find((s) => s.id === selectedServiceId);
-        invariant(service, "selectService returned service ID not in the list");
+        const selected = services.find((s) => s.id === selectedServiceId);
+        invariant(
+          selected,
+          "selectService returned service ID not in the list",
+        );
+        const service = yield* Result.await(
+          self.#api.getService(selectedServiceId, options.signal),
+        );
         return Result.ok({
           projectId,
           serviceId: selectedServiceId,
-          serviceName: service.name,
+          serviceName: service.name ?? selected.name,
           region: service.region.id,
+          branchId: service.branchId ?? null,
           isNewService: false,
         });
       }
@@ -1307,11 +1349,94 @@ export class ComputeClient {
         serviceId: response.id,
         serviceName: response.name,
         region: response.region.id,
+        branchId: response.branchId ?? null,
         isNewService: true,
       });
     });
   }
 
+  async #applyEnvVars(
+    projectId: string,
+    branchId: string | null,
+    envVars: Record<string, string | null> | undefined,
+    signal?: AbortSignal,
+  ): Promise<Result<void, ApiRequestError>> {
+    if (!envVars || Object.keys(envVars).length === 0) {
+      return Result.ok(undefined);
+    }
+
+    const self = this;
+    return Result.gen(async function* () {
+      const scope = yield* Result.await(
+        self.#resolveEnvironmentVariableScope(projectId, branchId, signal),
+      );
+      for (const [key, value] of Object.entries(envVars)) {
+        yield* self.#checkAborted(signal);
+        const existing = yield* Result.await(
+          self.#api.listEnvironmentVariables({ ...scope, key }, signal),
+        );
+        const current = existing[0];
+
+        if (value === null) {
+          if (current) {
+            yield* self.#checkAborted(signal);
+            // Do not pass signal to mutating transport; aborting it can make remote completion ambiguous.
+            yield* Result.await(
+              self.#api.deleteEnvironmentVariable(current.id),
+            );
+          }
+          continue;
+        }
+
+        if (current) {
+          yield* self.#checkAborted(signal);
+          // Do not pass signal to mutating transport; aborting it can make remote completion ambiguous.
+          yield* Result.await(
+            self.#api.updateEnvironmentVariable(current.id, { value }),
+          );
+          continue;
+        }
+
+        yield* self.#checkAborted(signal);
+        // Do not pass signal to mutating transport; aborting it can make remote completion ambiguous.
+        yield* Result.await(
+          self.#api.createEnvironmentVariable({ ...scope, key, value }),
+        );
+      }
+
+      return Result.ok(undefined);
+    });
+  }
+
+  async #resolveEnvironmentVariableScope(
+    projectId: string,
+    branchId: string | null,
+    signal?: AbortSignal,
+  ): Promise<
+    Result<
+      | { projectId: string; class: "production" }
+      | {
+          projectId: string;
+          class: "preview";
+          branchId: string;
+        },
+      ApiRequestError
+    >
+  > {
+    if (!branchId) {
+      return Result.ok({ projectId, class: "production" });
+    }
+
+    const branch = await this.#api.getBranch(branchId, signal);
+    if (branch.isErr()) return branch;
+
+    if (branch.value.role === "preview") {
+      return Result.ok({ projectId, class: "preview", branchId });
+    }
+
+    return Result.ok({ projectId, class: "production" });
+  }
+
   async #uploadArtifactResult(
     url: string,
     body: Uint8Array,

package/src/config/frameworks.ts

@@ -0,0 +1,187 @@
+import type { ComputeFramework } from "./types.ts";
+
+/**
+ * Framework capability registry — the single source of truth for what each
+ * supported framework is and can do. Commands, config validation, detection,
+ * and prompts all query this table; adding a framework means adding one
+ * entry here plus its build/run strategy implementation.
+ */
+
+export type FrameworkBuildType =
+  | "nextjs"
+  | "nuxt"
+  | "astro"
+  | "tanstack-start"
+  | "bun";
+
+export interface FrameworkDescriptor {
+  readonly key: ComputeFramework;
+  readonly displayName: string;
+  /** Build/deploy strategy this framework uses. */
+  readonly buildType: FrameworkBuildType;
+  /** Accepted user-facing spellings, lowercased, including the key. */
+  readonly aliases: readonly string[];
+  /** Dependencies whose presence detects this framework. */
+  readonly detectPackages: readonly string[];
+  /** Config files whose presence detects this framework. */
+  readonly detectConfigFiles: readonly string[];
+  /** Consumes a user-provided source entrypoint instead of build output. */
+  readonly usesEntrypoint: boolean;
+  /** Entrypoint assumed when the package defines none. */
+  readonly defaultEntrypoint: string | null;
+  /** Has a local dev server (`app run`) in the current preview. */
+  readonly hasLocalDevServer: boolean;
+}
+
+export const NEXT_CONFIG_FILENAMES = [
+  "next.config.js",
+  "next.config.mjs",
+  "next.config.ts",
+  "next.config.mts",
+] as const;
+
+export const NUXT_CONFIG_FILENAMES = [
+  "nuxt.config.js",
+  "nuxt.config.mjs",
+  "nuxt.config.cjs",
+  "nuxt.config.ts",
+  "nuxt.config.mts",
+] as const;
+
+export const ASTRO_CONFIG_FILENAMES = [
+  "astro.config.js",
+  "astro.config.mjs",
+  "astro.config.cjs",
+  "astro.config.ts",
+  "astro.config.mts",
+] as const;
+
+// Detection checks frameworks in this order; keep more specific signals first.
+export const FRAMEWORKS: readonly FrameworkDescriptor[] = [
+  {
+    key: "nextjs",
+    displayName: "Next.js",
+    buildType: "nextjs",
+    aliases: ["nextjs", "next", "next.js"],
+    detectPackages: ["next"],
+    detectConfigFiles: NEXT_CONFIG_FILENAMES,
+    usesEntrypoint: false,
+    defaultEntrypoint: null,
+    hasLocalDevServer: true,
+  },
+  {
+    key: "nuxt",
+    displayName: "Nuxt",
+    buildType: "nuxt",
+    aliases: ["nuxt", "nuxtjs", "nuxt.js"],
+    detectPackages: ["nuxt"],
+    detectConfigFiles: NUXT_CONFIG_FILENAMES,
+    usesEntrypoint: false,
+    defaultEntrypoint: null,
+    hasLocalDevServer: false,
+  },
+  {
+    key: "astro",
+    displayName: "Astro",
+    buildType: "astro",
+    aliases: ["astro"],
+    detectPackages: ["astro"],
+    detectConfigFiles: ASTRO_CONFIG_FILENAMES,
+    usesEntrypoint: false,
+    defaultEntrypoint: null,
+    hasLocalDevServer: false,
+  },
+  {
+    key: "hono",
+    displayName: "Hono",
+    buildType: "bun",
+    aliases: ["hono"],
+    detectPackages: ["hono"],
+    detectConfigFiles: [],
+    usesEntrypoint: true,
+    defaultEntrypoint: "src/index.ts",
+    hasLocalDevServer: true,
+  },
+  {
+    key: "tanstack-start",
+    displayName: "TanStack Start",
+    buildType: "tanstack-start",
+    aliases: [
+      "tanstack-start",
+      "tanstack",
+      "@tanstack/react-start",
+      "@tanstack/solid-start",
+    ],
+    detectPackages: ["@tanstack/react-start", "@tanstack/solid-start"],
+    detectConfigFiles: [],
+    usesEntrypoint: false,
+    defaultEntrypoint: null,
+    hasLocalDevServer: false,
+  },
+  {
+    key: "bun",
+    displayName: "Bun",
+    buildType: "bun",
+    aliases: ["bun"],
+    detectPackages: [],
+    detectConfigFiles: [],
+    usesEntrypoint: true,
+    defaultEntrypoint: null,
+    hasLocalDevServer: true,
+  },
+];
+
+export const FRAMEWORK_KEYS = FRAMEWORKS.map((framework) => framework.key);
+
+/**
+ * Build types whose preview build consumes committed build settings. The
+ * others (nuxt, astro) run their framework CLI and stage fixed output, so a
+ * config `build` block has nothing to apply to.
+ */
+export const CONFIG_BACKED_BUILD_TYPES = [
+  "nextjs",
+  "tanstack-start",
+  "bun",
+] as const satisfies readonly FrameworkBuildType[];
+
+export type ConfigBackedBuildType = (typeof CONFIG_BACKED_BUILD_TYPES)[number];
+
+/** Build types that consume a user-provided source entrypoint. */
+export const ENTRYPOINT_BUILD_TYPES: readonly FrameworkBuildType[] = [
+  ...new Set(
+    FRAMEWORKS.filter((framework) => framework.usesEntrypoint).map(
+      (framework) => framework.buildType,
+    ),
+  ),
+];
+
+/** Build types `app run` can start a local dev server for. */
+export const LOCAL_DEV_BUILD_TYPES: readonly FrameworkBuildType[] = [
+  ...new Set(
+    FRAMEWORKS.filter((framework) => framework.hasLocalDevServer).map(
+      (framework) => framework.buildType,
+    ),
+  ),
+];
+
+export function frameworkByKey(key: ComputeFramework): FrameworkDescriptor {
+  const framework = FRAMEWORKS.find((candidate) => candidate.key === key);
+  if (!framework) {
+    throw new Error(`Unknown framework key "${key}".`);
+  }
+  return framework;
+}
+
+export function frameworkFromAlias(value: string): FrameworkDescriptor | null {
+  const normalized = value.trim().toLowerCase();
+  return (
+    FRAMEWORKS.find((framework) => framework.aliases.includes(normalized)) ??
+    null
+  );
+}
+
+export function isConfigBackedBuildType(
+  value: string,
+): value is ConfigBackedBuildType {
+  return (CONFIG_BACKED_BUILD_TYPES as readonly string[]).includes(value);
+}

package/src/config/index.ts

@@ -0,0 +1,59 @@
+/**
+ * The compute config contract and its tooling: types, validation, discovery,
+ * loading, and serialization for `prisma.compute.ts`.
+ *
+ * Consumers (CLI, build-runner, scaffolding) share this module so every part
+ * of the platform reads the same deploy graph. Consumer-specific concerns —
+ * project/branch resolution, prompts, flag precedence — stay with consumers.
+ */
+
+export {
+  ASTRO_CONFIG_FILENAMES,
+  CONFIG_BACKED_BUILD_TYPES,
+  type ConfigBackedBuildType,
+  ENTRYPOINT_BUILD_TYPES,
+  FRAMEWORK_KEYS,
+  FRAMEWORKS,
+  type FrameworkBuildType,
+  type FrameworkDescriptor,
+  frameworkByKey,
+  frameworkFromAlias,
+  isConfigBackedBuildType,
+  LOCAL_DEV_BUILD_TYPES,
+  NEXT_CONFIG_FILENAMES,
+  NUXT_CONFIG_FILENAMES,
+} from "./frameworks.ts";
+export {
+  COMPUTE_CONFIG_FILENAME,
+  COMPUTE_CONFIG_FILENAMES,
+  ComputeConfigAmbiguousError,
+  type ComputeConfigError,
+  ComputeConfigLoadError,
+  findComputeConfigCandidates,
+  findComputeConfigDir,
+  loadComputeConfig,
+} from "./load.ts";
+export {
+  ComputeConfigInvalidError,
+  type ComputeConfigTargetError,
+  ComputeConfigTargetRequiredError,
+  ComputeConfigTargetUnknownError,
+  type ComputeDeployTarget,
+  type ComputeDeployTargetBuild,
+  computeTargetAppDir,
+  inferComputeTargetFromCwd,
+  type LoadedComputeConfig,
+  normalizeComputeConfig,
+  selectComputeDeployTarget,
+} from "./normalize.ts";
+export { serializeComputeConfig } from "./serialize.ts";
+export { resolveSourceRoot, sourceRootLineage } from "./source-root.ts";
+export {
+  COMPUTE_FRAMEWORKS,
+  type ComputeAppConfig,
+  type ComputeBuildConfig,
+  type ComputeConfig,
+  type ComputeEnvConfig,
+  type ComputeFramework,
+  defineComputeConfig,
+} from "./types.ts";