@prisma/compute-sdk 0.25.0 → 0.27.0

package/dist/workspace.js

@@ -0,0 +1,205 @@
+import { spawn } from "node:child_process";
+import { readFile, stat } from "node:fs/promises";
+import path from "node:path";
+import { sourceRootLineage } from "./config/source-root.js";
+/**
+ * Detects the package manager governing `appPath` by walking from the app up
+ * to the source root: the nearest `packageManager` field wins, then the
+ * nearest lockfile. Workspace repos keep both at the root, so a package
+ * deep in a monorepo still resolves correctly. Returns undefined when no
+ * signal is found.
+ */
+export async function resolvePackageManager(appPath, signal) {
+    for (const directory of await sourceRootLineage(appPath, signal)) {
+        const manifest = await readPackageManifest(directory, signal);
+        const fromField = packageManagerFromField(manifest?.packageManager);
+        if (fromField) {
+            return fromField;
+        }
+        if ((await pathExists(path.join(directory, "bun.lock"), signal)) ||
+            (await pathExists(path.join(directory, "bun.lockb"), signal))) {
+            return "bun";
+        }
+        if (await pathExists(path.join(directory, "pnpm-lock.yaml"), signal)) {
+            return "pnpm";
+        }
+        if (await pathExists(path.join(directory, "yarn.lock"), signal)) {
+            return "yarn";
+        }
+        if (await pathExists(path.join(directory, "package-lock.json"), signal)) {
+            return "npm";
+        }
+    }
+    return undefined;
+}
+/**
+ * Build environment for `appPath`: every `node_modules/.bin` between the app
+ * and its source root, prepended to PATH. Workspace repos hoist binaries like
+ * `next` to the workspace root, so a build run from a package directory still
+ * finds them. The returned object is suitable as the `env` for a child build
+ * process.
+ */
+export async function buildCommandEnv(appPath, baseEnv, signal) {
+    const binDirs = (await sourceRootLineage(appPath, signal)).map((directory) => path.join(directory, "node_modules", ".bin"));
+    return {
+        ...baseEnv,
+        PATH: [...binDirs, baseEnv.PATH].filter(Boolean).join(path.delimiter),
+    };
+}
+/**
+ * Runs a build command string inside `appPath`, with every ancestor
+ * `node_modules/.bin` on PATH so workspace-hoisted binaries resolve. Rejects
+ * with the framework prefix and captured output on a non-zero exit.
+ */
+export async function runBuildCommand(options) {
+    const env = await buildCommandEnv(options.appPath, { ...process.env, ...options.env }, options.signal);
+    // `shell: true` preserves the platform shell so a command string like
+    // `pnpm run build` works the same as the CLI's previous `exec`.
+    await runChildProcess({
+        command: options.command,
+        args: [],
+        cwd: options.appPath,
+        env,
+        shell: true,
+        failurePrefix: options.failurePrefix,
+        onOutput: options.onOutput,
+        signal: options.signal,
+    });
+}
+/**
+ * Spawns a child build process, streaming each output line to `onOutput` and
+ * keeping a bounded tail for the failure message instead of buffering the whole
+ * build. Resolves on a zero exit; rejects on a non-zero exit (with the prefix,
+ * exit code, and tail) or a spawn error (whose `code`, e.g. ENOENT, is
+ * preserved on the rejection so a launcher ladder can branch on it).
+ *
+ * Shared by `runBuildCommand` (a shell command string) and `runPackageCli`
+ * (an explicit binary + args).
+ */
+export function runChildProcess(options) {
+    return new Promise((resolve, reject) => {
+        const tail = createBoundedTail();
+        const child = spawn(options.command, [...options.args], {
+            cwd: options.cwd,
+            env: options.env,
+            signal: options.signal,
+            shell: options.shell ?? false,
+        });
+        const streamed = Promise.all([
+            streamLines(child.stdout, "stdout", tail, options.onOutput),
+            streamLines(child.stderr, "stderr", tail, options.onOutput),
+        ]);
+        child.on("error", (error) => {
+            // Preserve `code` (e.g. ENOENT) so a launcher ladder can fall through.
+            reject(Object.assign(new Error(`${options.failurePrefix} build failed:\n${error.message}`), { code: error.code }));
+        });
+        child.on("close", (code) => {
+            streamed.then(() => {
+                if (code === 0) {
+                    resolve();
+                    return;
+                }
+                const detail = tail.text().trim();
+                const exit = code != null ? ` (exit code ${code})` : "";
+                reject(new Error(`${options.failurePrefix} build failed${exit}${detail ? `:\n${detail}` : "."}`));
+            }, reject);
+        });
+    });
+}
+/** Splits a child stream into lines, taps each, and records it in the tail. */
+function streamLines(stream, source, tail, onOutput) {
+    return new Promise((resolve) => {
+        if (!stream) {
+            resolve();
+            return;
+        }
+        stream.setEncoding("utf8");
+        let buffer = "";
+        const emit = (line) => {
+            tail.push(line);
+            onOutput?.(line, source);
+        };
+        stream.on("data", (chunk) => {
+            buffer += chunk;
+            let newline = buffer.indexOf("\n");
+            while (newline !== -1) {
+                emit(buffer.slice(0, newline));
+                buffer = buffer.slice(newline + 1);
+                newline = buffer.indexOf("\n");
+            }
+        });
+        stream.on("end", () => {
+            if (buffer.length > 0) {
+                emit(buffer);
+            }
+            resolve();
+        });
+        // A stream error surfaces through the child's own error/close handlers.
+        stream.on("error", () => resolve());
+    });
+}
+/** A ring of the most recent output lines, for the failure message. */
+function createBoundedTail(maxLines = 200) {
+    const lines = [];
+    return {
+        push(line) {
+            lines.push(line);
+            if (lines.length > maxLines) {
+                lines.shift();
+            }
+        },
+        text() {
+            return lines.join("\n");
+        },
+    };
+}
+/** Reads and parses `appPath/package.json`, returning null on any failure. */
+export async function readPackageManifest(appPath, signal) {
+    signal?.throwIfAborted();
+    try {
+        const content = await readFile(path.join(appPath, "package.json"), {
+            encoding: "utf-8",
+            signal,
+        });
+        const parsed = JSON.parse(content);
+        return isRecord(parsed) ? parsed : null;
+    }
+    catch (error) {
+        // A missing file or invalid JSON is expected; an abort must propagate.
+        if (signal?.aborted)
+            throw error;
+        return null;
+    }
+}
+/** The trimmed `scripts.build` string, or null when absent or empty. */
+export function readBuildScript(manifest) {
+    const build = manifest?.scripts?.build;
+    if (typeof build !== "string") {
+        return null;
+    }
+    const trimmed = build.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function packageManagerFromField(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const name = value.split("@")[0];
+    return name === "bun" || name === "pnpm" || name === "yarn" || name === "npm"
+        ? name
+        : null;
+}
+async function pathExists(targetPath, signal) {
+    signal?.throwIfAborted();
+    try {
+        await stat(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma/compute-sdk",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "description": "TypeScript SDK for deploying and managing applications on Prisma Compute",
   "license": "Apache-2.0",
   "repository": "prisma/project-compute",
@@ -38,10 +38,11 @@
   },
   "dependencies": {
     "better-result": "^2.7.0",
+    "jiti": "^2.7.0",
+    "magicast": "^0.5.3",
     "tar-stream": "^3.1.8",
     "tiny-invariant": "1.3.3",
-    "ws": "^8.20.0",
-    "jiti": "^2.7.0"
+    "ws": "^8.20.0"
   },
   "peerDependencies": {
     "@prisma/management-api-sdk": ">=1.36.0"

package/src/artifact-stage.ts

@@ -0,0 +1,280 @@
+import {
+  chmod,
+  copyFile,
+  lstat,
+  mkdir,
+  readdir,
+  readlink,
+  stat,
+} from "node:fs/promises";
+import path from "node:path";
+
+import { resolveSourceRoot } from "./config/source-root.ts";
+
+/**
+ * Stages a framework's standalone output (e.g. Next.js `.next/standalone`)
+ * into a deployable artifact directory, materializing the symlinks the output
+ * carries into the workspace `node_modules` and hoisting isolated-store
+ * dependencies (pnpm `.pnpm`, bun `.bun`) so Node resolution works once the
+ * artifact is unpacked elsewhere.
+ *
+ * Location-agnostic: the workspace boundary is resolved from `appPath`, not
+ * the current working directory.
+ */
+export async function stageStandaloneArtifact(options: {
+  standaloneDir: string;
+  artifactDir: string;
+  appPath: string;
+  signal?: AbortSignal;
+}): Promise<void> {
+  const standaloneRoot = path.resolve(options.standaloneDir);
+  const artifactRoot = path.resolve(options.artifactDir);
+  const appRoot = path.resolve(options.appPath);
+  const sourceRoot = await resolveSourceRoot(appRoot, options.signal);
+
+  await copyPathMaterializingSymlinks(standaloneRoot, artifactRoot, {
+    standaloneRoot,
+    appRoot,
+    sourceRoot,
+    signal: options.signal,
+  });
+  await hoistIsolatedStoreDependencies(
+    path.join(artifactRoot, "node_modules"),
+    options.signal,
+  );
+}
+
+/** Options shared by the symlink-materializing copy walk. */
+interface MaterializeOptions {
+  /** Root of the standalone output being copied (for fallback resolution). */
+  standaloneRoot: string;
+  /** The app directory; symlink targets here are materialized. */
+  appRoot: string;
+  /** The workspace/source root; targets in its node_modules are materialized. */
+  sourceRoot: string;
+  signal?: AbortSignal;
+}
+
+/**
+ * pnpm and bun (isolated linker) both keep packages in a virtual store with a
+ * shared symlink farm (`.pnpm/node_modules`, `.bun/node_modules`). Hoist the
+ * farm entries to the artifact's `node_modules` root so Node-style resolution
+ * works after symlinks are materialized.
+ */
+export async function hoistIsolatedStoreDependencies(
+  nodeModulesDir: string,
+  signal?: AbortSignal,
+): Promise<void> {
+  await hoistStoreDependencies(
+    nodeModulesDir,
+    path.join(nodeModulesDir, ".pnpm", "node_modules"),
+    signal,
+  );
+  await hoistStoreDependencies(
+    nodeModulesDir,
+    path.join(nodeModulesDir, ".bun", "node_modules"),
+    signal,
+  );
+}
+
+async function hoistStoreDependencies(
+  nodeModulesDir: string,
+  storeNodeModulesDir: string,
+  signal?: AbortSignal,
+): Promise<void> {
+  if (!(await directoryExists(storeNodeModulesDir, signal))) {
+    return;
+  }
+
+  const entries = await readEntries(storeNodeModulesDir, signal);
+  for (const entry of entries) {
+    const sourcePath = path.join(storeNodeModulesDir, entry.name);
+
+    if (entry.name.startsWith("@") && entry.isDirectory()) {
+      const scopedEntries = await readEntries(sourcePath, signal);
+      for (const scopedEntry of scopedEntries) {
+        const scopedDestination = path.join(
+          nodeModulesDir,
+          entry.name,
+          scopedEntry.name,
+        );
+        if (await pathExists(scopedDestination, signal)) {
+          continue;
+        }
+        signal?.throwIfAborted();
+        await mkdir(path.dirname(scopedDestination), { recursive: true });
+        await copyPathMaterializingSymlinks(
+          path.join(sourcePath, scopedEntry.name),
+          scopedDestination,
+          storeMaterializeOptions(storeNodeModulesDir, nodeModulesDir, signal),
+        );
+      }
+      continue;
+    }
+
+    const destinationPath = path.join(nodeModulesDir, entry.name);
+    if (await pathExists(destinationPath, signal)) {
+      continue;
+    }
+
+    await copyPathMaterializingSymlinks(
+      sourcePath,
+      destinationPath,
+      storeMaterializeOptions(storeNodeModulesDir, nodeModulesDir, signal),
+    );
+  }
+}
+
+function storeMaterializeOptions(
+  storeNodeModulesDir: string,
+  nodeModulesDir: string,
+  signal?: AbortSignal,
+): MaterializeOptions {
+  return {
+    standaloneRoot: storeNodeModulesDir,
+    appRoot: nodeModulesDir,
+    sourceRoot: nodeModulesDir,
+    signal,
+  };
+}
+
+async function copyPathMaterializingSymlinks(
+  sourcePath: string,
+  destinationPath: string,
+  options: MaterializeOptions,
+): Promise<void> {
+  options.signal?.throwIfAborted();
+  const sourceStat = await lstat(sourcePath);
+
+  if (sourceStat.isSymbolicLink()) {
+    const resolvedTarget = await resolveSymlinkTarget(sourcePath, options);
+    if (resolvedTarget === null) {
+      return;
+    }
+    await copyPathMaterializingSymlinks(
+      resolvedTarget,
+      destinationPath,
+      options,
+    );
+    return;
+  }
+
+  if (sourceStat.isDirectory()) {
+    await mkdir(destinationPath, { recursive: true });
+    const entries = await readEntries(sourcePath, options.signal);
+    for (const entry of entries) {
+      await copyPathMaterializingSymlinks(
+        path.join(sourcePath, entry.name),
+        path.join(destinationPath, entry.name),
+        options,
+      );
+    }
+    return;
+  }
+
+  if (sourceStat.isFile()) {
+    await mkdir(path.dirname(destinationPath), { recursive: true });
+    await copyFile(sourcePath, destinationPath);
+    await chmod(destinationPath, sourceStat.mode);
+  }
+}
+
+async function resolveSymlinkTarget(
+  symlinkPath: string,
+  options: MaterializeOptions,
+): Promise<string | null> {
+  options.signal?.throwIfAborted();
+  const linkTarget = await readlink(symlinkPath);
+  const resolvedTarget = path.resolve(path.dirname(symlinkPath), linkTarget);
+
+  if (await pathExists(resolvedTarget, options.signal)) {
+    if (
+      !isPathWithin(options.appRoot, resolvedTarget) &&
+      !isPathWithinWorkspaceDependency(options.sourceRoot, resolvedTarget)
+    ) {
+      throw new Error(
+        `Build artifact symlink escapes the app directory: ${resolvedTarget}`,
+      );
+    }
+    return resolvedTarget;
+  }
+
+  if (isPathWithin(options.standaloneRoot, resolvedTarget)) {
+    const fallbackTarget = path.join(
+      options.appRoot,
+      path.relative(options.standaloneRoot, resolvedTarget),
+    );
+    if (await pathExists(fallbackTarget, options.signal)) {
+      return fallbackTarget;
+    }
+  }
+
+  // pnpm's hoist layer (.pnpm/node_modules/*) contains speculative links that
+  // are routinely dangling — Next's tracer doesn't always align with what pnpm
+  // populated. Drop these silently. Dangling links elsewhere still throw so a
+  // real missing dep doesn't get masked.
+  if (isPnpmHoistLink(symlinkPath)) {
+    return null;
+  }
+
+  throw new Error(
+    `Standalone symlink target is missing: ${symlinkPath} -> ${linkTarget} (resolved to ${resolvedTarget})`,
+  );
+}
+
+function isPnpmHoistLink(symlinkPath: string): boolean {
+  const parts = path.dirname(symlinkPath).split(path.sep);
+  for (let i = 0; i < parts.length - 1; i++) {
+    if (parts[i] === ".pnpm" && parts[i + 1] === "node_modules") {
+      return true;
+    }
+  }
+  return false;
+}
+
+function isPathWithin(rootPath: string, candidatePath: string): boolean {
+  const relativePath = path.relative(rootPath, candidatePath);
+  return (
+    relativePath === "" ||
+    (!relativePath.startsWith(`..${path.sep}`) &&
+      relativePath !== ".." &&
+      !path.isAbsolute(relativePath))
+  );
+}
+
+function isPathWithinWorkspaceDependency(
+  sourceRoot: string,
+  candidatePath: string,
+): boolean {
+  return isPathWithin(path.join(sourceRoot, "node_modules"), candidatePath);
+}
+
+async function readEntries(directory: string, signal?: AbortSignal) {
+  signal?.throwIfAborted();
+  return readdir(directory, { withFileTypes: true });
+}
+
+async function pathExists(
+  targetPath: string,
+  signal?: AbortSignal,
+): Promise<boolean> {
+  signal?.throwIfAborted();
+  try {
+    await stat(targetPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function directoryExists(
+  targetPath: string,
+  signal?: AbortSignal,
+): Promise<boolean> {
+  signal?.throwIfAborted();
+  try {
+    return (await stat(targetPath)).isDirectory();
+  } catch {
+    return false;
+  }
+}

package/src/astro-build.ts

@@ -1,12 +1,16 @@
 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 { BuildArtifact, BuildStrategy } from "./build-strategy.ts";
 import {
   hasPackageDependency,
   hasRootFile,
   runPackageCli,
 } from "./build-strategy.ts";
+import { defaultHttpPortForBuildType } from "./config/frameworks.ts";
+import type { BuildCommandIo } from "./workspace.ts";
 
 const ASTRO_CONFIG_FILENAMES = [
   "astro.config.js",
@@ -22,9 +26,11 @@ const ASTRO_CONFIG_FILENAMES = [
  */
 export class AstroBuild implements BuildStrategy {
   readonly #appPath: string;
+  readonly #io?: BuildCommandIo;
 
-  constructor(options: { appPath: string }) {
+  constructor(options: { appPath: string; io?: BuildCommandIo }) {
     this.#appPath = options.appPath;
+    this.#io = options.io;
   }
 
   async canBuild(signal?: AbortSignal): Promise<boolean> {
@@ -43,6 +49,8 @@ export class AstroBuild implements BuildStrategy {
       failurePrefix: "Astro",
       missingMessage:
         "Could not find the Astro CLI. Install it with `npm install astro` or ensure npx/bunx is available.",
+      env: this.#io?.env,
+      onOutput: this.#io?.onOutput,
       signal,
     });
 
@@ -63,11 +71,14 @@ export class AstroBuild implements BuildStrategy {
         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/entry.mjs",
-        defaultPortMapping: { http: 4321 },
+        defaultPortMapping: { http: defaultHttpPortForBuildType("astro") },
         cleanup: () => rm(outDir, { recursive: true, force: true }),
       };
     } catch (error) {

package/src/auto-build.ts

@@ -1,47 +1,41 @@
-import { AstroBuild } from "./astro-build.ts";
+import { type BuildStrategyHooks, resolveBuildStrategy } from "./build.ts";
 import type { BuildArtifact, BuildStrategy } from "./build-strategy.ts";
-import { BunBuild } from "./bun-build.ts";
-import { NextjsBuild } from "./nextjs-build.ts";
-import { NuxtBuild } from "./nuxt-build.ts";
-import { TanstackStartBuild } from "./tanstack-start-build.ts";
 
 /**
- * Meta-strategy that auto-detects the appropriate build strategy.
- * Iterates over candidates and delegates to the first one that can handle the app.
+ * Meta-strategy that auto-detects the appropriate framework build strategy and
+ * delegates to it. Detection runs in registry order with bun as the universal
+ * fallback, so a buildable strategy always resolves. Use `resolveBuildStrategy`
+ * directly when the resolved build type is also needed.
  */
 export class AutoBuild implements BuildStrategy {
-  readonly #strategies: BuildStrategy[];
+  readonly #appPath: string;
+  readonly #entrypoint?: string;
+  readonly #hooks: BuildStrategyHooks;
 
-  constructor(options: { appPath: string; entrypoint?: string }) {
-    this.#strategies = [
-      new NextjsBuild({ appPath: options.appPath }),
-      new NuxtBuild({ appPath: options.appPath }),
-      new AstroBuild({ appPath: options.appPath }),
-      new TanstackStartBuild({ appPath: options.appPath }),
-      new BunBuild({
-        appPath: options.appPath,
-        entrypoint: options.entrypoint,
-      }),
-    ];
+  constructor(
+    options: { appPath: string; entrypoint?: string } & BuildStrategyHooks,
+  ) {
+    this.#appPath = options.appPath;
+    this.#entrypoint = options.entrypoint;
+    this.#hooks = {
+      io: options.io,
+      requireStandalone: options.requireStandalone,
+    };
   }
 
-  async canBuild(signal?: AbortSignal): Promise<boolean> {
-    for (const strategy of this.#strategies) {
-      signal?.throwIfAborted();
-      if (await strategy.canBuild(signal)) {
-        return true;
-      }
-    }
-    return false;
+  async canBuild(_signal?: AbortSignal): Promise<boolean> {
+    // Detection always resolves (bun is the universal fallback).
+    return true;
   }
 
   async execute(signal?: AbortSignal): Promise<BuildArtifact> {
-    for (const strategy of this.#strategies) {
-      signal?.throwIfAborted();
-      if (await strategy.canBuild(signal)) {
-        return strategy.execute(signal);
-      }
-    }
-    throw new Error("No suitable build strategy found for this application");
+    const { strategy } = await resolveBuildStrategy({
+      appPath: this.#appPath,
+      entrypoint: this.#entrypoint,
+      buildType: "auto",
+      signal,
+      ...this.#hooks,
+    });
+    return strategy.execute(signal);
   }
 }