payload 4.0.0-internal.e7d4ebc → 4.0.0-internal.ee5d8bd

package/dist/bin/build.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/bin/build.ts"],"sourcesContent":["/* eslint-disable no-console */\nimport { spawn } from 'node:child_process'\nimport fs, { readFileSync } from 'node:fs'\nimport { createRequire } from 'node:module'\nimport path from 'node:path'\n\nimport type { SanitizedConfig } from '../config/types.js'\n\nimport { NEXT_PAYLOAD_ROUTE_GROUP, TANSTACK_PAYLOAD_DIR } from './frameworkConventions.js'\nimport { generateImportMap } from './generateImportMap/index.js'\nimport { generateTypes } from './generateTypes.js'\n\ntype Framework = 'next' | 'tanstack-start'\n\nconst NEXT_CONFIG_FILES = ['next.config.js', 'next.config.ts', 'next.config.mjs', 'next.config.cjs']\nconst VITE_CONFIG_FILES = [\n  'vite.config.js',\n  'vite.config.ts',\n  'vite.config.mjs',\n  'vite.config.cjs',\n  'vite.config.cts',\n  'vite.config.mts',\n]\n\n/**\n * `payload build` — generate the import map (and types) so they are on disk\n * before the framework build statically imports them, then detect the project's\n * framework (Next.js or TanStack Start) and run its build, forwarding any extra\n * CLI args verbatim.\n *\n * Owns its own process lifecycle: it exits with the framework build's exit code,\n * or exits 1 if pre-build generation or framework detection fails (never builds\n * against a stale map or the wrong bundler).\n */\nexport async function build({ config }: { config: SanitizedConfig }): Promise<void> {\n  const skipTypes = process.argv.includes('--no-types')\n\n  try {\n    await generateImportMap(config, { log: true })\n    if (!skipTypes) {\n      await generateTypes(config, { log: true })\n    }\n  } catch (err) {\n    console.error('Pre-build generation failed:')\n    console.error(err)\n    return process.exit(1)\n  }\n\n  let bin: string\n  let args: string[]\n  try {\n    const framework = detectFramework()\n    ;({ args, bin } = resolveBuildCommand({ forwardedArgs: getForwardedArgs(), framework }))\n  } catch (err) {\n    console.error(err instanceof Error ? err.message : err)\n    return process.exit(1)\n  }\n\n  const exitCode = await new Promise<number>((resolve) => {\n    const child = spawn(process.execPath, [bin, ...args], {\n      stdio: 'inherit',\n    })\n    child.on('error', (err) => {\n      console.error('Failed to run build:')\n      console.error(err)\n      resolve(1)\n    })\n    child.on('exit', (code) => {\n      resolve(code ?? 0)\n    })\n  })\n\n  process.exit(exitCode)\n}\n\n/**\n * Determine whether the project builds with Next.js or TanStack Start. An explicit\n * `PAYLOAD_FRAMEWORK` env wins; otherwise tries the most intentional signals first\n * — declared dependencies, then framework config files, then Payload's\n * admin-route folder conventions — falling through when a layer is inconclusive.\n * Throws with guidance for an unsupported override or when no single framework can\n * be determined.\n */\nexport function detectFramework(cwd: string = process.cwd()): Framework {\n  const override = process.env.PAYLOAD_FRAMEWORK\n  if (override) {\n    if (isFramework(override)) {\n      return override\n    }\n    throw new Error(\n      `PAYLOAD_FRAMEWORK is set to \"${override}\", which is not supported. Use one of: next, tanstack-start.`,\n    )\n  }\n\n  const deps = readProjectDependencies(cwd)\n  const hasNextDep = Boolean(deps.next)\n  const hasTanstackDep = Boolean(deps['@tanstack/react-start'])\n  if (hasNextDep && !hasTanstackDep) {\n    return 'next'\n  }\n  if (hasTanstackDep && !hasNextDep) {\n    return 'tanstack-start'\n  }\n\n  const hasNextConfig = NEXT_CONFIG_FILES.some((file) => fs.existsSync(path.join(cwd, file)))\n  const hasViteConfig = VITE_CONFIG_FILES.some((file) => fs.existsSync(path.join(cwd, file)))\n  if (hasNextConfig && !hasViteConfig) {\n    return 'next'\n  }\n  if (hasViteConfig && !hasNextConfig) {\n    return 'tanstack-start'\n  }\n\n  const hasNextFolder = [\n    path.join(cwd, 'app', NEXT_PAYLOAD_ROUTE_GROUP),\n    path.join(cwd, 'src', 'app', NEXT_PAYLOAD_ROUTE_GROUP),\n  ].some((dir) => fs.existsSync(dir))\n  const hasTanstackFolder = [\n    path.join(cwd, 'app', TANSTACK_PAYLOAD_DIR),\n    path.join(cwd, 'src', 'app', TANSTACK_PAYLOAD_DIR),\n  ].some((dir) => fs.existsSync(dir))\n  if (hasNextFolder && !hasTanstackFolder) {\n    return 'next'\n  }\n  if (hasTanstackFolder && !hasNextFolder) {\n    return 'tanstack-start'\n  }\n\n  throw new Error(\n    buildDetectionError({\n      hasNextConfig,\n      hasNextDep,\n      hasNextFolder,\n      hasTanstackDep,\n      hasTanstackFolder,\n      hasViteConfig,\n    }),\n  )\n}\n\n/** Resolve the project's `next` binary — see {@link resolveBin}. */\nexport function resolveNextBin(cwd: string = process.cwd()): string {\n  return resolveBin({ cwd, displayName: 'Next.js', packageName: 'next' })\n}\n\n/** Resolve the project's `vite` binary — see {@link resolveBin}. */\nexport function resolveViteBin(cwd: string = process.cwd()): string {\n  return resolveBin({ cwd, displayName: 'Vite', packageName: 'vite' })\n}\n\n/**\n * Map a detected framework to the resolved binary and argument list to spawn.\n * Both frameworks take the `build` subcommand followed by the forwarded args.\n */\nexport function resolveBuildCommand({\n  cwd = process.cwd(),\n  forwardedArgs,\n  framework,\n}: {\n  cwd?: string\n  forwardedArgs: string[]\n  framework: Framework\n}): { args: string[]; bin: string } {\n  const bin = framework === 'next' ? resolveNextBin(cwd) : resolveViteBin(cwd)\n  return { args: ['build', ...forwardedArgs], bin }\n}\n\n/**\n * Forward the raw args that follow the `build` subcommand to the framework build\n * (`next build` / `vite build`), dropping payload-only flags. Uses raw argv (not\n * minimist) so flags like `--turbopack` (Next) or `--mode staging` (Vite) pass\n * through verbatim.\n */\nexport function getForwardedArgs(argv: string[] = process.argv.slice(2)): string[] {\n  const buildIndex = argv.indexOf('build')\n  const rest = buildIndex === -1 ? argv : argv.slice(buildIndex + 1)\n  return rest.filter((arg) => arg !== '--no-types')\n}\n\nfunction isFramework(value: string): value is Framework {\n  return value === 'next' || value === 'tanstack-start'\n}\n\nfunction readProjectDependencies(cwd: string): Record<string, string> {\n  try {\n    const pkg = JSON.parse(readFileSync(path.join(cwd, 'package.json'), 'utf8')) as {\n      dependencies?: Record<string, string>\n      devDependencies?: Record<string, string>\n    }\n    return { ...pkg.dependencies, ...pkg.devDependencies }\n  } catch {\n    return {}\n  }\n}\n\nfunction buildDetectionError(signals: {\n  hasNextConfig: boolean\n  hasNextDep: boolean\n  hasNextFolder: boolean\n  hasTanstackDep: boolean\n  hasTanstackFolder: boolean\n  hasViteConfig: boolean\n}): string {\n  const conflicts: string[] = []\n  if (signals.hasNextDep && signals.hasTanstackDep) {\n    conflicts.push('dependencies (`next` and `@tanstack/react-start`)')\n  }\n  if (signals.hasNextConfig && signals.hasViteConfig) {\n    conflicts.push('config files (next.config.* and vite.config.*)')\n  }\n  if (signals.hasNextFolder && signals.hasTanstackFolder) {\n    conflicts.push('app folders (app/(payload) and app/_payload)')\n  }\n\n  if (conflicts.length) {\n    return `Could not determine your framework for \\`payload build\\`: conflicting signals found in ${conflicts.join(', ')}. Resolve the conflict so only one framework is indicated.`\n  }\n\n  return [\n    'Could not determine your framework for `payload build`.',\n    'Checked:',\n    '  • dependencies: no `next` or `@tanstack/react-start` in package.json',\n    '  • config files: no next.config.* or vite.config.*',\n    '  • app folders:  no app/(payload) or app/_payload',\n    'Install your framework (Next.js or TanStack Start) and try again.',\n  ].join('\\n')\n}\n\n/**\n * Resolve a framework's binary path from its own package manifest, robust to a\n * future `exports` field and to internal layout changes. Resolving from `cwd`\n * (not PATH) works whether `payload build` runs via an npm script or `npx`.\n */\nfunction resolveBin({\n  cwd,\n  displayName,\n  packageName,\n}: {\n  cwd: string\n  displayName: string\n  packageName: string\n}): string {\n  const require = createRequire(path.join(cwd, 'package.json'))\n\n  let pkgPath: string\n  try {\n    pkgPath = require.resolve(`${packageName}/package.json`)\n  } catch {\n    throw new Error(\n      `Could not resolve \"${packageName}\" from the current project. Is ${displayName} installed?`,\n    )\n  }\n\n  const pkg = JSON.parse(readFileSync(pkgPath, 'utf8')) as {\n    bin?: Record<string, string> | string\n  }\n  const binField = typeof pkg.bin === 'string' ? pkg.bin : pkg.bin?.[packageName]\n  if (!binField) {\n    throw new Error(\n      `Could not determine the \"${packageName}\" binary path from ${packageName}/package.json.`,\n    )\n  }\n\n  return path.join(path.dirname(pkgPath), binField)\n}\n"],"names":["spawn","fs","readFileSync","createRequire","path","NEXT_PAYLOAD_ROUTE_GROUP","TANSTACK_PAYLOAD_DIR","generateImportMap","generateTypes","NEXT_CONFIG_FILES","VITE_CONFIG_FILES","build","config","skipTypes","process","argv","includes","log","err","console","error","exit","bin","args","framework","detectFramework","resolveBuildCommand","forwardedArgs","getForwardedArgs","Error","message","exitCode","Promise","resolve","child","execPath","stdio","on","code","cwd","override","env","PAYLOAD_FRAMEWORK","isFramework","deps","readProjectDependencies","hasNextDep","Boolean","next","hasTanstackDep","hasNextConfig","some","file","existsSync","join","hasViteConfig","hasNextFolder","dir","hasTanstackFolder","buildDetectionError","resolveNextBin","resolveBin","displayName","packageName","resolveViteBin","slice","buildIndex","indexOf","rest","filter","arg","value","pkg","JSON","parse","dependencies","devDependencies","signals","conflicts","push","length","require","pkgPath","binField","dirname"],"mappings":"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"}

package/dist/bin/build.spec.js

@@ -1,594 +0,0 @@
-import { existsSync, mkdirSync, mkdtempSync, realpathSync, rmSync, writeFileSync } from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { describe, expect, it, vi, beforeEach, afterEach } from 'vitest';
-// Default fake child auto-fires `exit(0)` synchronously so ordering/generation
-// tests resolve. Specific tests override via `mockReturnValueOnce` to drive the
-// exit/error handlers manually.
-const spawnMock = vi.fn(()=>({
-        on (event, cb) {
-            if (event === 'exit') {
-                cb(0);
-            }
-            return this;
-        }
-    }));
-const generateImportMapMock = vi.fn(async ()=>{});
-const generateTypesMock = vi.fn(async ()=>{});
-vi.mock('node:child_process', ()=>({
-        spawn: spawnMock
-    }));
-vi.mock('./generateImportMap/index.js', ()=>({
-        generateImportMap: generateImportMapMock
-    }));
-vi.mock('./generateTypes.js', ()=>({
-        generateTypes: generateTypesMock
-    }));
-// Imported after mocks are registered
-const { build, detectFramework, getForwardedArgs, resolveBuildCommand, resolveNextBin, resolveViteBin } = await import('./build.js');
-const fakeConfig = {};
-describe('getForwardedArgs', ()=>{
-    it('returns args after the build token and strips --no-types', ()=>{
-        expect(getForwardedArgs([
-            'build',
-            '--turbopack',
-            '--no-types',
-            'foo'
-        ])).toEqual([
-            '--turbopack',
-            'foo'
-        ]);
-    });
-    it('returns empty array when only build is present', ()=>{
-        expect(getForwardedArgs([
-            'build'
-        ])).toEqual([]);
-    });
-});
-describe('resolveNextBin', ()=>{
-    it('resolves next bin from the current project', ()=>{
-        // next is installed at the repo root; resolving from cwd must succeed
-        const binPath = resolveNextBin(process.cwd());
-        expect(binPath).toMatch(/next[\\/].*bin[\\/]next$/);
-        expect(existsSync(binPath)).toBe(true);
-    });
-    it('throws a clear error when next cannot be resolved', ()=>{
-        expect(()=>resolveNextBin('/nonexistent-project-root')).toThrow(/next/i);
-    });
-});
-describe('resolveViteBin', ()=>{
-    it('resolves the vite bin from the current project', ()=>{
-        // vite is installed at the repo root; resolving from cwd must succeed
-        const binPath = resolveViteBin(process.cwd());
-        expect(binPath).toMatch(/vite[\\/].*bin[\\/]vite\.js$/);
-        expect(existsSync(binPath)).toBe(true);
-    });
-    it('throws a clear error when vite cannot be resolved', async ()=>{
-        // Vitest injects its own transitive `vite` dep onto NODE_PATH, so resolving
-        // "vite" from any cwd would otherwise succeed in this test process even
-        // when the project under test has no vite installed. Mock module
-        // resolution itself to simulate a real "vite not installed" project.
-        vi.resetModules();
-        vi.doMock('node:module', async (importOriginal)=>{
-            const actual = await importOriginal();
-            return {
-                ...actual,
-                createRequire: ()=>({
-                        resolve: ()=>{
-                            throw new Error('Cannot find module');
-                        }
-                    })
-            };
-        });
-        const { resolveViteBin: resolveViteBinWithoutVite } = await import('./build.js');
-        expect(()=>resolveViteBinWithoutVite('/nonexistent-project-root')).toThrow(/vite/i);
-        vi.doUnmock('node:module');
-        vi.resetModules();
-    });
-});
-describe('resolveBuildCommand', ()=>{
-    it('maps next to the next bin and build args', ()=>{
-        const { args, bin } = resolveBuildCommand({
-            cwd: process.cwd(),
-            forwardedArgs: [
-                '--turbopack'
-            ],
-            framework: 'next'
-        });
-        expect(bin).toMatch(/next[\\/].*bin[\\/]next$/);
-        expect(args).toEqual([
-            'build',
-            '--turbopack'
-        ]);
-    });
-    it('maps tanstack-start to the vite bin and build args', ()=>{
-        const { args, bin } = resolveBuildCommand({
-            cwd: process.cwd(),
-            forwardedArgs: [
-                '--mode',
-                'staging'
-            ],
-            framework: 'tanstack-start'
-        });
-        expect(bin).toMatch(/vite[\\/].*bin[\\/]vite\.js$/);
-        expect(args).toEqual([
-            'build',
-            '--mode',
-            'staging'
-        ]);
-    });
-});
-// Resolution against isolated fixture projects, complementing the cwd/real-install
-// checks above. Installing a fake package into a real temp node_modules proves
-// `createRequire` walks the consumer's node_modules rather than repo hoisting or
-// vitest's ambient NODE_PATH, and exercises bin-field shapes the real installs don't.
-describe('bin resolution walks the consumer project node_modules', ()=>{
-    const binFixtureDirs = [];
-    /**
-   * Build a throwaway project with a fake installed package whose package.json
-   * carries the given `bin` field. Returns the project root to pass as `cwd`. The
-   * bin target file is created so existsSync assertions are meaningful.
-   */ const makeProjectWithPackage = ({ binField, binRelPath, packageName })=>{
-        // realpath so exact path comparisons hold on macOS, where /var symlinks to
-        // /private/var and require.resolve returns the resolved path.
-        const root = realpathSync(mkdtempSync(path.join(os.tmpdir(), 'payload-build-bin-')));
-        binFixtureDirs.push(root);
-        writeFileSync(path.join(root, 'package.json'), JSON.stringify({
-            name: 'fixture-app'
-        }));
-        const pkgDir = path.join(root, 'node_modules', packageName);
-        mkdirSync(pkgDir, {
-            recursive: true
-        });
-        writeFileSync(path.join(pkgDir, 'package.json'), JSON.stringify({
-            bin: binField,
-            name: packageName,
-            version: '0.0.0'
-        }));
-        if (binRelPath) {
-            const binFull = path.join(pkgDir, binRelPath);
-            mkdirSync(path.dirname(binFull), {
-                recursive: true
-            });
-            writeFileSync(binFull, '');
-        }
-        return root;
-    };
-    afterEach(()=>{
-        for (const dir of binFixtureDirs){
-            rmSync(dir, {
-                force: true,
-                recursive: true
-            });
-        }
-        binFixtureDirs.length = 0;
-    });
-    it('resolves the next bin from an isolated project using the object-form bin field', ()=>{
-        const root = makeProjectWithPackage({
-            binField: {
-                next: './dist/bin/next'
-            },
-            binRelPath: 'dist/bin/next',
-            packageName: 'next'
-        });
-        const binPath = resolveNextBin(root);
-        expect(binPath).toBe(path.join(root, 'node_modules', 'next', 'dist', 'bin', 'next'));
-        expect(existsSync(binPath)).toBe(true);
-    });
-    it('resolves the vite bin from an isolated project using the object-form bin field', ()=>{
-        const root = makeProjectWithPackage({
-            binField: {
-                vite: 'bin/vite.js'
-            },
-            binRelPath: 'bin/vite.js',
-            packageName: 'vite'
-        });
-        const binPath = resolveViteBin(root);
-        expect(binPath).toBe(path.join(root, 'node_modules', 'vite', 'bin', 'vite.js'));
-        expect(existsSync(binPath)).toBe(true);
-    });
-    it('resolves a string-form bin field', ()=>{
-        const root = makeProjectWithPackage({
-            binField: './cli.js',
-            binRelPath: 'cli.js',
-            packageName: 'vite'
-        });
-        const binPath = resolveViteBin(root);
-        expect(binPath).toBe(path.join(root, 'node_modules', 'vite', 'cli.js'));
-        expect(existsSync(binPath)).toBe(true);
-    });
-    it('throws a clear error when the package declares no bin field', ()=>{
-        const root = makeProjectWithPackage({
-            binField: undefined,
-            packageName: 'vite'
-        });
-        expect(()=>resolveViteBin(root)).toThrow(/binary path/i);
-    });
-});
-describe('build', ()=>{
-    let exitMock;
-    let originalArgv;
-    let originalFrameworkEnv;
-    let cwdSpy;
-    const buildTempDirs = [];
-    beforeEach(()=>{
-        spawnMock.mockClear();
-        generateImportMapMock.mockClear();
-        generateTypesMock.mockClear();
-        originalArgv = process.argv;
-        process.argv = [
-            'node',
-            'payload',
-            'build'
-        ];
-        exitMock = vi.spyOn(process, 'exit').mockImplementation(()=>undefined);
-        originalFrameworkEnv = process.env.PAYLOAD_FRAMEWORK;
-        // Force next for the legacy tests so they don't depend on the repo-root
-        // package.json's ambient `next` dependency for auto-detection.
-        process.env.PAYLOAD_FRAMEWORK = 'next';
-    });
-    afterEach(()=>{
-        process.argv = originalArgv;
-        exitMock.mockRestore();
-        if (originalFrameworkEnv === undefined) {
-            delete process.env.PAYLOAD_FRAMEWORK;
-        } else {
-            process.env.PAYLOAD_FRAMEWORK = originalFrameworkEnv;
-        }
-        if (cwdSpy) {
-            cwdSpy.mockRestore();
-            cwdSpy = undefined;
-        }
-        for (const dir of buildTempDirs){
-            rmSync(dir, {
-                force: true,
-                recursive: true
-            });
-        }
-        buildTempDirs.length = 0;
-    });
-    it('generates the import map before spawning, and generates types by default', async ()=>{
-        await build({
-            config: fakeConfig
-        });
-        expect(generateImportMapMock).toHaveBeenCalledTimes(1);
-        expect(generateTypesMock).toHaveBeenCalledTimes(1);
-        expect(spawnMock).toHaveBeenCalledTimes(1);
-        expect(generateImportMapMock.mock.invocationCallOrder[0]).toBeLessThan(spawnMock.mock.invocationCallOrder[0]);
-    });
-    it('skips type generation with --no-types', async ()=>{
-        process.argv = [
-            'node',
-            'payload',
-            'build',
-            '--no-types'
-        ];
-        await build({
-            config: fakeConfig
-        });
-        expect(generateImportMapMock).toHaveBeenCalledTimes(1);
-        expect(generateTypesMock).not.toHaveBeenCalled();
-        expect(spawnMock).toHaveBeenCalledTimes(1);
-    });
-    it('exits 1 and does not spawn when generation fails', async ()=>{
-        generateImportMapMock.mockRejectedValueOnce(new Error('boom'));
-        await build({
-            config: fakeConfig
-        });
-        expect(exitMock).toHaveBeenCalledWith(1);
-        expect(spawnMock).not.toHaveBeenCalled();
-    });
-    it('spawns next build with forwarded args and propagates the child exit code', async ()=>{
-        process.argv = [
-            'node',
-            'payload',
-            'build',
-            '--turbopack'
-        ];
-        let exitCb;
-        spawnMock.mockReturnValueOnce({
-            on (event, cb) {
-                if (event === 'exit') {
-                    exitCb = cb;
-                }
-                return this;
-            }
-        });
-        const buildPromise = build({
-            config: fakeConfig
-        });
-        // generation awaits before spawn; let those microtasks settle
-        await vi.waitFor(()=>expect(spawnMock).toHaveBeenCalledTimes(1));
-        const [execPath, spawnArgs, opts] = spawnMock.mock.calls[0];
-        expect(execPath).toBe(process.execPath);
-        expect(spawnArgs[1]).toBe('build');
-        expect(spawnArgs).toContain('--turbopack');
-        expect(opts).toEqual({
-            stdio: 'inherit'
-        });
-        // Simulate the child exiting with a non-zero code
-        exitCb?.(2);
-        await buildPromise;
-        expect(exitMock).toHaveBeenCalledWith(2);
-    });
-    it('does not exit until the spawned child exits, then propagates its code', async ()=>{
-        let exitCb;
-        spawnMock.mockReturnValueOnce({
-            on (event, cb) {
-                if (event === 'exit') {
-                    exitCb = cb;
-                }
-                return this;
-            }
-        });
-        let resolved = false;
-        const buildPromise = build({
-            config: fakeConfig
-        }).then(()=>{
-            resolved = true;
-        });
-        // Wait for generation to settle and the child to be spawned. build() must
-        // still be pending because the child has not exited yet.
-        await vi.waitFor(()=>expect(exitCb).toBeDefined());
-        // Flush all pending microtasks; the OLD (buggy) build() resolved here
-        // without awaiting the child, so this assertion catches the race.
-        await new Promise((r)=>setTimeout(r, 0));
-        expect(resolved).toBe(false);
-        expect(exitMock).not.toHaveBeenCalled();
-        // Child exits non-zero -> build() must exit with that exact code
-        exitCb?.(3);
-        await buildPromise;
-        expect(resolved).toBe(true);
-        expect(exitMock).toHaveBeenCalledWith(3);
-    });
-    it('spawns vite build for a detected tanstack project', async ()=>{
-        delete process.env.PAYLOAD_FRAMEWORK;
-        process.argv = [
-            'node',
-            'payload',
-            'build',
-            '--mode',
-            'staging'
-        ];
-        const tanstackDir = mkdtempSync(path.join(os.tmpdir(), 'payload-build-ts-'));
-        buildTempDirs.push(tanstackDir);
-        writeFileSync(path.join(tanstackDir, 'package.json'), JSON.stringify({
-            dependencies: {
-                '@tanstack/react-start': '1.168.26'
-            }
-        }));
-        cwdSpy = vi.spyOn(process, 'cwd').mockReturnValue(tanstackDir);
-        await build({
-            config: fakeConfig
-        });
-        expect(spawnMock).toHaveBeenCalledTimes(1);
-        const [, spawnArgs] = spawnMock.mock.calls[0];
-        expect(spawnArgs[0]).toMatch(/vite[\\/].*bin[\\/]vite\.js$/);
-        expect(spawnArgs.slice(1)).toEqual([
-            'build',
-            '--mode',
-            'staging'
-        ]);
-    });
-    it('exits 1 and does not spawn when the framework cannot be detected', async ()=>{
-        delete process.env.PAYLOAD_FRAMEWORK;
-        const emptyDir = mkdtempSync(path.join(os.tmpdir(), 'payload-build-empty-'));
-        buildTempDirs.push(emptyDir);
-        writeFileSync(path.join(emptyDir, 'package.json'), JSON.stringify({}));
-        cwdSpy = vi.spyOn(process, 'cwd').mockReturnValue(emptyDir);
-        await build({
-            config: fakeConfig
-        });
-        expect(exitMock).toHaveBeenCalledWith(1);
-        expect(spawnMock).not.toHaveBeenCalled();
-    });
-});
-describe('detectFramework', ()=>{
-    const createdDirs = [];
-    let originalFrameworkEnv;
-    const makeProject = (files)=>{
-        const dir = mkdtempSync(path.join(os.tmpdir(), 'payload-build-'));
-        createdDirs.push(dir);
-        for (const file of files){
-            const full = path.join(dir, file.path);
-            mkdirSync(path.dirname(full), {
-                recursive: true
-            });
-            writeFileSync(full, file.contents ?? '');
-        }
-        return dir;
-    };
-    const pkg = (deps)=>JSON.stringify({
-            dependencies: deps
-        });
-    beforeEach(()=>{
-        originalFrameworkEnv = process.env.PAYLOAD_FRAMEWORK;
-        delete process.env.PAYLOAD_FRAMEWORK;
-    });
-    afterEach(()=>{
-        if (originalFrameworkEnv === undefined) {
-            delete process.env.PAYLOAD_FRAMEWORK;
-        } else {
-            process.env.PAYLOAD_FRAMEWORK = originalFrameworkEnv;
-        }
-        for (const dir of createdDirs){
-            rmSync(dir, {
-                force: true,
-                recursive: true
-            });
-        }
-        createdDirs.length = 0;
-    });
-    it('honors PAYLOAD_FRAMEWORK=tanstack-start over auto-detection', ()=>{
-        process.env.PAYLOAD_FRAMEWORK = 'tanstack-start';
-        const dir = makeProject([
-            {
-                contents: pkg({
-                    next: '15.0.0'
-                }),
-                path: 'package.json'
-            }
-        ]);
-        expect(detectFramework(dir)).toBe('tanstack-start');
-    });
-    it('honors PAYLOAD_FRAMEWORK=next over auto-detection', ()=>{
-        process.env.PAYLOAD_FRAMEWORK = 'next';
-        const dir = makeProject([
-            {
-                contents: pkg({
-                    '@tanstack/react-start': '1.168.26'
-                }),
-                path: 'package.json'
-            }
-        ]);
-        expect(detectFramework(dir)).toBe('next');
-    });
-    it('throws when PAYLOAD_FRAMEWORK is an unsupported value', ()=>{
-        process.env.PAYLOAD_FRAMEWORK = 'svelte';
-        const dir = makeProject([
-            {
-                contents: pkg({
-                    next: '15.0.0'
-                }),
-                path: 'package.json'
-            }
-        ]);
-        expect(()=>detectFramework(dir)).toThrow(/PAYLOAD_FRAMEWORK/);
-    });
-    it('detects next from the next dependency', ()=>{
-        const dir = makeProject([
-            {
-                contents: pkg({
-                    next: '15.0.0'
-                }),
-                path: 'package.json'
-            }
-        ]);
-        expect(detectFramework(dir)).toBe('next');
-    });
-    it('detects tanstack-start from the @tanstack/react-start dependency', ()=>{
-        const dir = makeProject([
-            {
-                contents: pkg({
-                    '@tanstack/react-start': '1.168.26'
-                }),
-                path: 'package.json'
-            }
-        ]);
-        expect(detectFramework(dir)).toBe('tanstack-start');
-    });
-    it('falls back to next.config when deps are inconclusive', ()=>{
-        const dir = makeProject([
-            {
-                contents: pkg({}),
-                path: 'package.json'
-            },
-            {
-                path: 'next.config.ts'
-            }
-        ]);
-        expect(detectFramework(dir)).toBe('next');
-    });
-    it('falls back to vite.config when deps are inconclusive', ()=>{
-        const dir = makeProject([
-            {
-                contents: pkg({}),
-                path: 'package.json'
-            },
-            {
-                path: 'vite.config.ts'
-            }
-        ]);
-        expect(detectFramework(dir)).toBe('tanstack-start');
-    });
-    it('falls back to the (payload) folder convention', ()=>{
-        const dir = makeProject([
-            {
-                path: 'app/(payload)/admin/page.tsx'
-            }
-        ]);
-        expect(detectFramework(dir)).toBe('next');
-    });
-    it('falls back to the _payload folder convention', ()=>{
-        const dir = makeProject([
-            {
-                path: 'app/_payload/route.tsx'
-            }
-        ]);
-        expect(detectFramework(dir)).toBe('tanstack-start');
-    });
-    it('resolves ambiguous deps using the config-file layer', ()=>{
-        const dir = makeProject([
-            {
-                contents: pkg({
-                    '@tanstack/react-start': '1.168.26',
-                    next: '15.0.0'
-                }),
-                path: 'package.json'
-            },
-            {
-                path: 'next.config.ts'
-            }
-        ]);
-        expect(detectFramework(dir)).toBe('next');
-    });
-    it('resolves ambiguous deps to tanstack-start via the config-file layer', ()=>{
-        const dir = makeProject([
-            {
-                contents: pkg({
-                    '@tanstack/react-start': '1.168.26',
-                    next: '15.0.0'
-                }),
-                path: 'package.json'
-            },
-            {
-                path: 'vite.config.ts'
-            }
-        ]);
-        expect(detectFramework(dir)).toBe('tanstack-start');
-    });
-    it('resolves ambiguous deps and configs via the folder-convention layer', ()=>{
-        const dir = makeProject([
-            {
-                contents: pkg({
-                    '@tanstack/react-start': '1.168.26',
-                    next: '15.0.0'
-                }),
-                path: 'package.json'
-            },
-            {
-                path: 'app/_payload/route.tsx'
-            }
-        ]);
-        expect(detectFramework(dir)).toBe('tanstack-start');
-    });
-    it('throws a no-framework error when nothing is detected', ()=>{
-        const dir = makeProject([
-            {
-                contents: pkg({}),
-                path: 'package.json'
-            }
-        ]);
-        expect(()=>detectFramework(dir)).toThrow(/Could not determine your framework/);
-    });
-    it('throws a conflict error when signals stay ambiguous', ()=>{
-        const dir = makeProject([
-            {
-                contents: pkg({
-                    '@tanstack/react-start': '1.168.26',
-                    next: '15.0.0'
-                }),
-                path: 'package.json'
-            },
-            {
-                path: 'next.config.ts'
-            },
-            {
-                path: 'vite.config.ts'
-            }
-        ]);
-        expect(()=>detectFramework(dir)).toThrow(/conflicting signals/);
-    });
-});
-
-//# sourceMappingURL=build.spec.js.map