@prisma/compute-sdk 0.26.0 → 0.28.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,6 +1,8 @@
 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,
@@ -8,6 +10,7 @@ import {
   runPackageCli,
 } from "./build-strategy.ts";
 import { defaultHttpPortForBuildType } from "./config/frameworks.ts";
+import type { BuildCommandIo } from "./workspace.ts";
 
 const ASTRO_CONFIG_FILENAMES = [
   "astro.config.js",
@@ -23,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> {
@@ -44,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,
     });
 
@@ -64,6 +71,9 @@ 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,

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);
   }
 }