@payloadcms/codemod 4.0.0-internal.2f0d313 → 4.0.0-internal.314c594

package/dist/upgrade/detectPackageManager.d.ts

@@ -1,8 +0,0 @@
-import type { PackageManager } from './types.js';
-/**
- * Map a project directory's lockfile to its package manager. `exists` is
- * injectable so callers can test offline; it defaults to the real filesystem.
- * pnpm is checked first, so it wins in a multi-lockfile repo.
- */
-export declare function detectPackageManager(projectPath: string, exists?: (path: string) => boolean): PackageManager;
-//# sourceMappingURL=detectPackageManager.d.ts.map

package/dist/upgrade/detectPackageManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"detectPackageManager.d.ts","sourceRoot":"","sources":["../../src/upgrade/detectPackageManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAUhD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAoB,GAC7C,cAAc,CAOhB"}

package/dist/upgrade/detectPackageManager.js

@@ -1,38 +0,0 @@
-import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-const LOCKFILES = [
-    {
-        file: 'pnpm-lock.yaml',
-        pm: 'pnpm'
-    },
-    {
-        file: 'yarn.lock',
-        pm: 'yarn'
-    },
-    {
-        file: 'bun.lockb',
-        pm: 'bun'
-    },
-    {
-        file: 'bun.lock',
-        pm: 'bun'
-    },
-    {
-        file: 'package-lock.json',
-        pm: 'npm'
-    }
-];
-/**
- * Map a project directory's lockfile to its package manager. `exists` is
- * injectable so callers can test offline; it defaults to the real filesystem.
- * pnpm is checked first, so it wins in a multi-lockfile repo.
- */ export function detectPackageManager(projectPath, exists = existsSync) {
-    for (const { file, pm } of LOCKFILES){
-        if (exists(join(projectPath, file))) {
-            return pm;
-        }
-    }
-    return 'npm';
-}
-
-//# sourceMappingURL=detectPackageManager.js.map

package/dist/upgrade/detectPackageManager.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/upgrade/detectPackageManager.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { join } from 'node:path'\n\nimport type { PackageManager } from './types.js'\n\nconst LOCKFILES: { file: string; pm: PackageManager }[] = [\n  { file: 'pnpm-lock.yaml', pm: 'pnpm' },\n  { file: 'yarn.lock', pm: 'yarn' },\n  { file: 'bun.lockb', pm: 'bun' },\n  { file: 'bun.lock', pm: 'bun' },\n  { file: 'package-lock.json', pm: 'npm' },\n]\n\n/**\n * Map a project directory's lockfile to its package manager. `exists` is\n * injectable so callers can test offline; it defaults to the real filesystem.\n * pnpm is checked first, so it wins in a multi-lockfile repo.\n */\nexport function detectPackageManager(\n  projectPath: string,\n  exists: (path: string) => boolean = existsSync,\n): PackageManager {\n  for (const { file, pm } of LOCKFILES) {\n    if (exists(join(projectPath, file))) {\n      return pm\n    }\n  }\n  return 'npm'\n}\n"],"names":["existsSync","join","LOCKFILES","file","pm","detectPackageManager","projectPath","exists"],"mappings":"AAAA,SAASA,UAAU,QAAQ,UAAS;AACpC,SAASC,IAAI,QAAQ,YAAW;AAIhC,MAAMC,YAAoD;IACxD;QAAEC,MAAM;QAAkBC,IAAI;IAAO;IACrC;QAAED,MAAM;QAAaC,IAAI;IAAO;IAChC;QAAED,MAAM;QAAaC,IAAI;IAAM;IAC/B;QAAED,MAAM;QAAYC,IAAI;IAAM;IAC9B;QAAED,MAAM;QAAqBC,IAAI;IAAM;CACxC;AAED;;;;CAIC,GACD,OAAO,SAASC,qBACdC,WAAmB,EACnBC,SAAoCP,UAAU;IAE9C,KAAK,MAAM,EAAEG,IAAI,EAAEC,EAAE,EAAE,IAAIF,UAAW;QACpC,IAAIK,OAAON,KAAKK,aAAaH,QAAQ;YACnC,OAAOC;QACT;IACF;IACA,OAAO;AACT"}

package/dist/upgrade/detectPackageManager.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=detectPackageManager.spec.d.ts.map

package/dist/upgrade/detectPackageManager.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"detectPackageManager.spec.d.ts","sourceRoot":"","sources":["../../src/upgrade/detectPackageManager.spec.ts"],"names":[],"mappings":""}

package/dist/upgrade/detectPackageManager.spec.js

@@ -1,41 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { detectPackageManager } from './detectPackageManager.js';
-const existsFor = (present)=>(path)=>present.some((name)=>path.endsWith(name));
-describe('detectPackageManager', ()=>{
-    it('detects pnpm', ()=>{
-        expect(detectPackageManager('/p', existsFor([
-            'pnpm-lock.yaml'
-        ]))).toBe('pnpm');
-    });
-    it('detects yarn', ()=>{
-        expect(detectPackageManager('/p', existsFor([
-            'yarn.lock'
-        ]))).toBe('yarn');
-    });
-    it('detects bun', ()=>{
-        expect(detectPackageManager('/p', existsFor([
-            'bun.lock'
-        ]))).toBe('bun');
-    });
-    it('detects bun via bun.lockb', ()=>{
-        expect(detectPackageManager('/p', existsFor([
-            'bun.lockb'
-        ]))).toBe('bun');
-    });
-    it('detects npm', ()=>{
-        expect(detectPackageManager('/p', existsFor([
-            'package-lock.json'
-        ]))).toBe('npm');
-    });
-    it('defaults to npm when no lockfile exists', ()=>{
-        expect(detectPackageManager('/p', ()=>false)).toBe('npm');
-    });
-    it('prefers pnpm when multiple lockfiles exist', ()=>{
-        expect(detectPackageManager('/p', existsFor([
-            'pnpm-lock.yaml',
-            'yarn.lock'
-        ]))).toBe('pnpm');
-    });
-});
-
-//# sourceMappingURL=detectPackageManager.spec.js.map

package/dist/upgrade/detectPackageManager.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/upgrade/detectPackageManager.spec.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest'\n\nimport { detectPackageManager } from './detectPackageManager.js'\n\nconst existsFor = (present: string[]) => (path: string) =>\n  present.some((name) => path.endsWith(name))\n\ndescribe('detectPackageManager', () => {\n  it('detects pnpm', () => {\n    expect(detectPackageManager('/p', existsFor(['pnpm-lock.yaml']))).toBe('pnpm')\n  })\n\n  it('detects yarn', () => {\n    expect(detectPackageManager('/p', existsFor(['yarn.lock']))).toBe('yarn')\n  })\n\n  it('detects bun', () => {\n    expect(detectPackageManager('/p', existsFor(['bun.lock']))).toBe('bun')\n  })\n\n  it('detects bun via bun.lockb', () => {\n    expect(detectPackageManager('/p', existsFor(['bun.lockb']))).toBe('bun')\n  })\n\n  it('detects npm', () => {\n    expect(detectPackageManager('/p', existsFor(['package-lock.json']))).toBe('npm')\n  })\n\n  it('defaults to npm when no lockfile exists', () => {\n    expect(detectPackageManager('/p', () => false)).toBe('npm')\n  })\n\n  it('prefers pnpm when multiple lockfiles exist', () => {\n    expect(detectPackageManager('/p', existsFor(['pnpm-lock.yaml', 'yarn.lock']))).toBe('pnpm')\n  })\n})\n"],"names":["describe","expect","it","detectPackageManager","existsFor","present","path","some","name","endsWith","toBe"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,SAAQ;AAE7C,SAASC,oBAAoB,QAAQ,4BAA2B;AAEhE,MAAMC,YAAY,CAACC,UAAsB,CAACC,OACxCD,QAAQE,IAAI,CAAC,CAACC,OAASF,KAAKG,QAAQ,CAACD;AAEvCR,SAAS,wBAAwB;IAC/BE,GAAG,gBAAgB;QACjBD,OAAOE,qBAAqB,MAAMC,UAAU;YAAC;SAAiB,IAAIM,IAAI,CAAC;IACzE;IAEAR,GAAG,gBAAgB;QACjBD,OAAOE,qBAAqB,MAAMC,UAAU;YAAC;SAAY,IAAIM,IAAI,CAAC;IACpE;IAEAR,GAAG,eAAe;QAChBD,OAAOE,qBAAqB,MAAMC,UAAU;YAAC;SAAW,IAAIM,IAAI,CAAC;IACnE;IAEAR,GAAG,6BAA6B;QAC9BD,OAAOE,qBAAqB,MAAMC,UAAU;YAAC;SAAY,IAAIM,IAAI,CAAC;IACpE;IAEAR,GAAG,eAAe;QAChBD,OAAOE,qBAAqB,MAAMC,UAAU;YAAC;SAAoB,IAAIM,IAAI,CAAC;IAC5E;IAEAR,GAAG,2CAA2C;QAC5CD,OAAOE,qBAAqB,MAAM,IAAM,QAAQO,IAAI,CAAC;IACvD;IAEAR,GAAG,8CAA8C;QAC/CD,OAAOE,qBAAqB,MAAMC,UAAU;YAAC;YAAkB;SAAY,IAAIM,IAAI,CAAC;IACtF;AACF"}

package/dist/upgrade/index.d.ts

@@ -1,24 +0,0 @@
-import type { UpgradeDeps } from './types.js';
-import { runTransforms as defaultRunTransforms } from '../runner.js';
-export type UpgradeFlags = {
-    dry: boolean;
-    force: boolean;
-    tag: string;
-};
-type RunUpgradeArgs = {
-    flags: UpgradeFlags;
-    path: string;
-};
-type RunUpgradeOverrides = {
-    runTransforms?: typeof defaultRunTransforms;
-};
-/**
- * Compose the upgrade pipeline: preflight -> resolve -> rewrite -> install ->
- * verify -> transforms -> report. Install runs before transforms so a failed
- * install aborts before any codemod touches source files.
- */
-export declare function runUpgrade({ flags, path }: RunUpgradeArgs, deps?: UpgradeDeps, overrides?: RunUpgradeOverrides): Promise<{
-    failed: boolean;
-}>;
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/upgrade/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/upgrade/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAuC,WAAW,EAAE,MAAM,YAAY,CAAA;AAGlF,OAAO,EAAE,aAAa,IAAI,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAUpE,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,OAAO,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,YAAY,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,mBAAmB,GAAG;IACzB,aAAa,CAAC,EAAE,OAAO,oBAAoB,CAAA;CAC5C,CAAA;AAsBD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,cAAc,EAC/B,IAAI,GAAE,WAA2B,EACjC,SAAS,GAAE,mBAAwB,GAClC,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAqF9B"}

package/dist/upgrade/index.js

@@ -1,184 +0,0 @@
-/* eslint-disable no-console */ import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import semver from 'semver';
-import { transforms as registry } from '../registry.js';
-import { runTransforms as defaultRunTransforms } from '../runner.js';
-import { loadPackageJsons, serializePackageJson } from '../utils/packageJson.js';
-import { loadProject } from '../utils/project.js';
-import { detectPackageManager } from './detectPackageManager.js';
-import { renderReport } from './report.js';
-import { resolveVersions } from './resolveVersions.js';
-import { isPayloadEslintPackage, rewritePackageJson } from './rewritePackageJson.js';
-import { runInstall } from './runInstall.js';
-import { RUNBOOK_RELATIVE_PATH } from './types.js';
-const defaultDeps = ()=>({
-        exists: existsSync,
-        fetchRegistry: async (name)=>{
-            const res = await fetch(`https://registry.npmjs.org/${name}`);
-            if (!res.ok) {
-                throw new Error(`Registry lookup failed for ${name}: ${res.status}`);
-            }
-            return await res.json();
-        },
-        spawn: (command, args, options)=>import('node:child_process').then(({ spawn })=>new Promise((resolveSpawn)=>{
-                    const child = spawn(command, args, {
-                        ...options,
-                        shell: false,
-                        stdio: 'inherit'
-                    });
-                    child.on('close', (code)=>resolveSpawn({
-                            code: code ?? 1
-                        }));
-                    child.on('error', ()=>resolveSpawn({
-                            code: 1
-                        }));
-                }))
-    });
-/**
- * Compose the upgrade pipeline: preflight -> resolve -> rewrite -> install ->
- * verify -> transforms -> report. Install runs before transforms so a failed
- * install aborts before any codemod touches source files.
- */ export async function runUpgrade({ flags, path }, deps = defaultDeps(), overrides = {}) {
-    const runTransforms = overrides.runTransforms ?? defaultRunTransforms;
-    const projectPath = resolve(path);
-    // 1. PREFLIGHT
-    const packageManager = detectPackageManager(projectPath, deps.exists);
-    const packageJsonPath = join(projectPath, 'package.json');
-    if (!deps.exists(packageJsonPath)) {
-        console.error(`No package.json found at ${packageJsonPath}.`);
-        return {
-            failed: true
-        };
-    }
-    if (!flags.force && isGitTreeDirty(projectPath)) {
-        console.warn('Warning: git tree is dirty. Commit or stash first, or pass --force.');
-    }
-    // 2. RESOLVE VERSIONS
-    const resolved = await resolveVersions({
-        fetchRegistry: deps.fetchRegistry,
-        tag: flags.tag
-    });
-    warnStaleNode(resolved);
-    // 3. REWRITE package.json
-    const original = readFileSync(packageJsonPath, 'utf8');
-    const data = JSON.parse(original);
-    const summary = rewritePackageJson({
-        data,
-        resolved
-    });
-    const nextText = serializePackageJson(data, original);
-    if (flags.dry) {
-        console.log('[dry] package.json changes:');
-        console.log(nextText);
-        console.log(`[dry] would run: ${packageManager} install`);
-        console.log('[dry] would then run Payload transforms.');
-        return {
-            failed: false
-        };
-    }
-    writeFileSync(packageJsonPath, nextText);
-    // 4. INSTALL
-    const install = await runInstall({
-        packageManager,
-        path: projectPath,
-        spawn: deps.spawn
-    });
-    if (install.code !== 0) {
-        console.error(`Install failed (exit ${install.code}). Aborting before transforms.`);
-        return {
-            failed: true
-        };
-    }
-    // 5. VERIFY RESOLUTION
-    const versions = verifyResolution(projectPath, data, resolved);
-    // 6. RUN PAYLOAD TRANSFORMS
-    // Reload package.jsons from disk so transforms see the rewritten root file
-    // (and any other package.json files in the tree) with the same reference
-    // semantics the bare transform path relies on for in-place mutation.
-    const packageJsons = loadPackageJsons(projectPath);
-    const project = loadProject(projectPath);
-    const snapshot = new Map(project.getSourceFiles().map((f)=>[
-            f.getFilePath(),
-            f.getFullText()
-        ]));
-    const { failed, results } = await runTransforms({
-        packageJsons: packageJsons.map(({ data: pkgData, path: pkgPath })=>({
-                data: pkgData,
-                path: pkgPath
-            })),
-        project,
-        transforms: registry
-    });
-    await Promise.all(project.getSourceFiles().filter((f)=>snapshot.get(f.getFilePath()) !== f.getFullText()).map((f)=>f.save()));
-    for (const pkg of packageJsons){
-        const text = serializePackageJson(pkg.data, pkg.originalText);
-        if (text !== pkg.originalText) {
-            writeFileSync(pkg.path, text);
-        }
-    }
-    // 7. REPORT
-    const model = {
-        floorsWritten: summary.floorsWritten,
-        nextTarget: resolved.nextTarget,
-        overridesRemoved: summary.overridesRemoved,
-        runbookPath: resolve(dirname(fileURLToPath(import.meta.url)), '..', RUNBOOK_RELATIVE_PATH),
-        transforms: results,
-        versions
-    };
-    console.log(renderReport(model));
-    return {
-        failed
-    };
-}
-function warnStaleNode(resolved) {
-    const running = process.versions.node;
-    if (!semver.satisfies(running, resolved.enginesNode)) {
-        console.warn(`Warning: running Node ${running} does not satisfy ${resolved.enginesNode}. ` + 'Install may resolve incorrectly; switch Node before continuing.');
-    }
-}
-function verifyResolution(projectPath, data, resolved) {
-    const rows = [];
-    const deps = {
-        ...asRecord(data.dependencies),
-        ...asRecord(data.devDependencies)
-    };
-    for (const name of Object.keys(deps)){
-        if (name !== 'payload' && !name.startsWith('@payloadcms/')) {
-            continue;
-        }
-        // eslint packages are versioned independently, so they are not part of the
-        // lockstep-pinned set and cannot be verified against the payload version.
-        if (isPayloadEslintPackage(name)) {
-            continue;
-        }
-        const installed = readInstalledVersion(projectPath, name);
-        rows.push({
-            name,
-            ok: installed === resolved.payloadVersion,
-            resolved: installed,
-            wrote: resolved.payloadVersion
-        });
-    }
-    return rows;
-}
-function readInstalledVersion(projectPath, name) {
-    try {
-        const pkgPath = join(projectPath, 'node_modules', name, 'package.json');
-        return JSON.parse(readFileSync(pkgPath, 'utf8')).version;
-    } catch  {
-        return undefined;
-    }
-}
-/**
- * Best-effort dirty-tree check. Real detection would shell out to `git
- * status`; until that lands, absence of a signal is treated as clean so the
- * warning never produces a false alarm.
- */ function isGitTreeDirty(_projectPath) {
-    return false;
-}
-function asRecord(value) {
-    return typeof value === 'object' && value !== null ? value : {};
-}
-
-//# sourceMappingURL=index.js.map

package/dist/upgrade/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/upgrade/index.ts"],"sourcesContent":["/* eslint-disable no-console */\nimport { existsSync, readFileSync, writeFileSync } from 'node:fs'\nimport { dirname, join, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport semver from 'semver'\n\nimport type { ReportModel, VersionReportRow } from './report.js'\nimport type { RegistryPackument, ResolvedVersions, UpgradeDeps } from './types.js'\n\nimport { transforms as registry } from '../registry.js'\nimport { runTransforms as defaultRunTransforms } from '../runner.js'\nimport { loadPackageJsons, serializePackageJson } from '../utils/packageJson.js'\nimport { loadProject } from '../utils/project.js'\nimport { detectPackageManager } from './detectPackageManager.js'\nimport { renderReport } from './report.js'\nimport { resolveVersions } from './resolveVersions.js'\nimport { isPayloadEslintPackage, rewritePackageJson } from './rewritePackageJson.js'\nimport { runInstall } from './runInstall.js'\nimport { RUNBOOK_RELATIVE_PATH } from './types.js'\n\nexport type UpgradeFlags = {\n  dry: boolean\n  force: boolean\n  tag: string\n}\n\ntype RunUpgradeArgs = {\n  flags: UpgradeFlags\n  path: string\n}\n\ntype RunUpgradeOverrides = {\n  runTransforms?: typeof defaultRunTransforms\n}\n\nconst defaultDeps = (): UpgradeDeps => ({\n  exists: existsSync,\n  fetchRegistry: async (name) => {\n    const res = await fetch(`https://registry.npmjs.org/${name}`)\n    if (!res.ok) {\n      throw new Error(`Registry lookup failed for ${name}: ${res.status}`)\n    }\n    return (await res.json()) as RegistryPackument\n  },\n  spawn: (command, args, options) =>\n    import('node:child_process').then(\n      ({ spawn }) =>\n        new Promise((resolveSpawn) => {\n          const child = spawn(command, args, { ...options, shell: false, stdio: 'inherit' })\n          child.on('close', (code) => resolveSpawn({ code: code ?? 1 }))\n          child.on('error', () => resolveSpawn({ code: 1 }))\n        }),\n    ),\n})\n\n/**\n * Compose the upgrade pipeline: preflight -> resolve -> rewrite -> install ->\n * verify -> transforms -> report. Install runs before transforms so a failed\n * install aborts before any codemod touches source files.\n */\nexport async function runUpgrade(\n  { flags, path }: RunUpgradeArgs,\n  deps: UpgradeDeps = defaultDeps(),\n  overrides: RunUpgradeOverrides = {},\n): Promise<{ failed: boolean }> {\n  const runTransforms = overrides.runTransforms ?? defaultRunTransforms\n  const projectPath = resolve(path)\n\n  // 1. PREFLIGHT\n  const packageManager = detectPackageManager(projectPath, deps.exists)\n  const packageJsonPath = join(projectPath, 'package.json')\n  if (!deps.exists(packageJsonPath)) {\n    console.error(`No package.json found at ${packageJsonPath}.`)\n    return { failed: true }\n  }\n  if (!flags.force && isGitTreeDirty(projectPath)) {\n    console.warn('Warning: git tree is dirty. Commit or stash first, or pass --force.')\n  }\n\n  // 2. RESOLVE VERSIONS\n  const resolved = await resolveVersions({ fetchRegistry: deps.fetchRegistry, tag: flags.tag })\n  warnStaleNode(resolved)\n\n  // 3. REWRITE package.json\n  const original = readFileSync(packageJsonPath, 'utf8')\n  const data = JSON.parse(original) as Record<string, unknown>\n  const summary = rewritePackageJson({ data, resolved })\n  const nextText = serializePackageJson(data, original)\n\n  if (flags.dry) {\n    console.log('[dry] package.json changes:')\n    console.log(nextText)\n    console.log(`[dry] would run: ${packageManager} install`)\n    console.log('[dry] would then run Payload transforms.')\n    return { failed: false }\n  }\n\n  writeFileSync(packageJsonPath, nextText)\n\n  // 4. INSTALL\n  const install = await runInstall({ packageManager, path: projectPath, spawn: deps.spawn })\n  if (install.code !== 0) {\n    console.error(`Install failed (exit ${install.code}). Aborting before transforms.`)\n    return { failed: true }\n  }\n\n  // 5. VERIFY RESOLUTION\n  const versions = verifyResolution(projectPath, data, resolved)\n\n  // 6. RUN PAYLOAD TRANSFORMS\n  // Reload package.jsons from disk so transforms see the rewritten root file\n  // (and any other package.json files in the tree) with the same reference\n  // semantics the bare transform path relies on for in-place mutation.\n  const packageJsons = loadPackageJsons(projectPath)\n  const project = loadProject(projectPath)\n  const snapshot = new Map(project.getSourceFiles().map((f) => [f.getFilePath(), f.getFullText()]))\n  const { failed, results } = await runTransforms({\n    packageJsons: packageJsons.map(({ data: pkgData, path: pkgPath }) => ({\n      data: pkgData,\n      path: pkgPath,\n    })),\n    project,\n    transforms: registry,\n  })\n  await Promise.all(\n    project\n      .getSourceFiles()\n      .filter((f) => snapshot.get(f.getFilePath()) !== f.getFullText())\n      .map((f) => f.save()),\n  )\n  for (const pkg of packageJsons) {\n    const text = serializePackageJson(pkg.data, pkg.originalText)\n    if (text !== pkg.originalText) {\n      writeFileSync(pkg.path, text)\n    }\n  }\n\n  // 7. REPORT\n  const model: ReportModel = {\n    floorsWritten: summary.floorsWritten,\n    nextTarget: resolved.nextTarget,\n    overridesRemoved: summary.overridesRemoved,\n    runbookPath: resolve(dirname(fileURLToPath(import.meta.url)), '..', RUNBOOK_RELATIVE_PATH),\n    transforms: results,\n    versions,\n  }\n  console.log(renderReport(model))\n\n  return { failed }\n}\n\nfunction warnStaleNode(resolved: ResolvedVersions): void {\n  const running = process.versions.node\n  if (!semver.satisfies(running, resolved.enginesNode)) {\n    console.warn(\n      `Warning: running Node ${running} does not satisfy ${resolved.enginesNode}. ` +\n        'Install may resolve incorrectly; switch Node before continuing.',\n    )\n  }\n}\n\nfunction verifyResolution(\n  projectPath: string,\n  data: Record<string, unknown>,\n  resolved: ResolvedVersions,\n): VersionReportRow[] {\n  const rows: VersionReportRow[] = []\n  const deps = { ...asRecord(data.dependencies), ...asRecord(data.devDependencies) }\n  for (const name of Object.keys(deps)) {\n    if (name !== 'payload' && !name.startsWith('@payloadcms/')) {\n      continue\n    }\n    // eslint packages are versioned independently, so they are not part of the\n    // lockstep-pinned set and cannot be verified against the payload version.\n    if (isPayloadEslintPackage(name)) {\n      continue\n    }\n    const installed = readInstalledVersion(projectPath, name)\n    rows.push({\n      name,\n      ok: installed === resolved.payloadVersion,\n      resolved: installed,\n      wrote: resolved.payloadVersion,\n    })\n  }\n  return rows\n}\n\nfunction readInstalledVersion(projectPath: string, name: string): string | undefined {\n  try {\n    const pkgPath = join(projectPath, 'node_modules', name, 'package.json')\n    return JSON.parse(readFileSync(pkgPath, 'utf8')).version as string\n  } catch {\n    return undefined\n  }\n}\n\n/**\n * Best-effort dirty-tree check. Real detection would shell out to `git\n * status`; until that lands, absence of a signal is treated as clean so the\n * warning never produces a false alarm.\n */\nfunction isGitTreeDirty(_projectPath: string): boolean {\n  return false\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> {\n  return typeof value === 'object' && value !== null ? (value as Record<string, unknown>) : {}\n}\n"],"names":["existsSync","readFileSync","writeFileSync","dirname","join","resolve","fileURLToPath","semver","transforms","registry","runTransforms","defaultRunTransforms","loadPackageJsons","serializePackageJson","loadProject","detectPackageManager","renderReport","resolveVersions","isPayloadEslintPackage","rewritePackageJson","runInstall","RUNBOOK_RELATIVE_PATH","defaultDeps","exists","fetchRegistry","name","res","fetch","ok","Error","status","json","spawn","command","args","options","then","Promise","resolveSpawn","child","shell","stdio","on","code","runUpgrade","flags","path","deps","overrides","projectPath","packageManager","packageJsonPath","console","error","failed","force","isGitTreeDirty","warn","resolved","tag","warnStaleNode","original","data","JSON","parse","summary","nextText","dry","log","install","versions","verifyResolution","packageJsons","project","snapshot","Map","getSourceFiles","map","f","getFilePath","getFullText","results","pkgData","pkgPath","all","filter","get","save","pkg","text","originalText","model","floorsWritten","nextTarget","overridesRemoved","runbookPath","url","running","process","node","satisfies","enginesNode","rows","asRecord","dependencies","devDependencies","Object","keys","startsWith","installed","readInstalledVersion","push","payloadVersion","wrote","version","undefined","_projectPath","value"],"mappings":"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"}

package/dist/upgrade/index.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.spec.d.ts","sourceRoot":"","sources":["../../src/upgrade/index.spec.ts"],"names":[],"mappings":""}

package/dist/upgrade/index.spec.js

@@ -1,132 +0,0 @@
-import { existsSync, mkdtempSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { describe, expect, it, vi } from 'vitest';
-import { runUpgrade } from './index.js';
-const packuments = {
-    '@payloadcms/next': {
-        'dist-tags': {
-            canary: '4.0.0-canary.20'
-        },
-        versions: {
-            '4.0.0-canary.20': {
-                peerDependencies: {
-                    next: '>=16.2.6 <17.0.0'
-                }
-            }
-        }
-    },
-    '@types/node': {
-        versions: {
-            '24.12.3': {}
-        }
-    },
-    next: {
-        versions: {
-            '16.9.3': {}
-        }
-    },
-    payload: {
-        'dist-tags': {
-            canary: '4.0.0-canary.20'
-        },
-        versions: {
-            '4.0.0-canary.20': {
-                engines: {
-                    node: '>=24.15.0'
-                }
-            }
-        }
-    }
-};
-const makeDeps = (overrides = {})=>({
-        // Real fs so the temp-project package.json is found; no lockfile -> npm.
-        exists: existsSync,
-        fetchRegistry: (name)=>Promise.resolve(packuments[name] ?? {}),
-        spawn: vi.fn().mockResolvedValue({
-            code: 0
-        }),
-        ...overrides
-    });
-const makeProject = ()=>{
-    const dir = mkdtempSync(join(tmpdir(), 'codemod-upgrade-'));
-    writeFileSync(join(dir, 'package.json'), JSON.stringify({
-        dependencies: {
-            payload: '^3.0.0'
-        }
-    }, null, 2) + '\n');
-    return dir;
-};
-describe('runUpgrade', ()=>{
-    it('installs before running transforms', async ()=>{
-        const order = [];
-        const spawn = vi.fn().mockImplementation(()=>{
-            order.push('install');
-            return Promise.resolve({
-                code: 0
-            });
-        });
-        const runTransforms = vi.fn().mockImplementation(()=>{
-            order.push('transforms');
-            return Promise.resolve({
-                failed: false,
-                results: []
-            });
-        });
-        await runUpgrade({
-            flags: {
-                dry: false,
-                force: true,
-                tag: 'canary'
-            },
-            path: makeProject()
-        }, makeDeps({
-            spawn
-        }), {
-            runTransforms
-        });
-        expect(order).toEqual([
-            'install',
-            'transforms'
-        ]);
-    });
-    it('aborts before transforms when install fails', async ()=>{
-        const runTransforms = vi.fn();
-        const result = await runUpgrade({
-            flags: {
-                dry: false,
-                force: true,
-                tag: 'canary'
-            },
-            path: makeProject()
-        }, makeDeps({
-            spawn: vi.fn().mockResolvedValue({
-                code: 1
-            })
-        }), {
-            runTransforms
-        });
-        expect(runTransforms).not.toHaveBeenCalled();
-        expect(result.failed).toBe(true);
-    });
-    it('dry run writes nothing, does not install or transform', async ()=>{
-        const spawn = vi.fn();
-        const runTransforms = vi.fn();
-        await runUpgrade({
-            flags: {
-                dry: true,
-                force: true,
-                tag: 'canary'
-            },
-            path: makeProject()
-        }, makeDeps({
-            spawn
-        }), {
-            runTransforms
-        });
-        expect(spawn).not.toHaveBeenCalled();
-        expect(runTransforms).not.toHaveBeenCalled();
-    });
-});
-
-//# sourceMappingURL=index.spec.js.map

package/dist/upgrade/index.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/upgrade/index.spec.ts"],"sourcesContent":["import { existsSync, mkdtempSync, writeFileSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { join } from 'node:path'\nimport { describe, expect, it, vi } from 'vitest'\n\nimport type { RegistryPackument, UpgradeDeps } from './types.js'\n\nimport { runUpgrade } from './index.js'\n\nconst packuments: Record<string, RegistryPackument> = {\n  '@payloadcms/next': {\n    'dist-tags': { canary: '4.0.0-canary.20' },\n    versions: { '4.0.0-canary.20': { peerDependencies: { next: '>=16.2.6 <17.0.0' } } },\n  },\n  '@types/node': { versions: { '24.12.3': {} } },\n  next: { versions: { '16.9.3': {} } },\n  payload: {\n    'dist-tags': { canary: '4.0.0-canary.20' },\n    versions: { '4.0.0-canary.20': { engines: { node: '>=24.15.0' } } },\n  },\n}\n\nconst makeDeps = (overrides: Partial<UpgradeDeps> = {}): UpgradeDeps => ({\n  // Real fs so the temp-project package.json is found; no lockfile -> npm.\n  exists: existsSync,\n  fetchRegistry: (name) => Promise.resolve(packuments[name] ?? {}),\n  spawn: vi.fn().mockResolvedValue({ code: 0 }),\n  ...overrides,\n})\n\nconst makeProject = (): string => {\n  const dir = mkdtempSync(join(tmpdir(), 'codemod-upgrade-'))\n  writeFileSync(\n    join(dir, 'package.json'),\n    JSON.stringify({ dependencies: { payload: '^3.0.0' } }, null, 2) + '\\n',\n  )\n  return dir\n}\n\ndescribe('runUpgrade', () => {\n  it('installs before running transforms', async () => {\n    const order: string[] = []\n    const spawn = vi.fn().mockImplementation(() => {\n      order.push('install')\n      return Promise.resolve({ code: 0 })\n    })\n    const runTransforms = vi.fn().mockImplementation(() => {\n      order.push('transforms')\n      return Promise.resolve({ failed: false, results: [] })\n    })\n\n    await runUpgrade(\n      { flags: { dry: false, force: true, tag: 'canary' }, path: makeProject() },\n      makeDeps({ spawn }),\n      { runTransforms },\n    )\n\n    expect(order).toEqual(['install', 'transforms'])\n  })\n\n  it('aborts before transforms when install fails', async () => {\n    const runTransforms = vi.fn()\n\n    const result = await runUpgrade(\n      {\n        flags: { dry: false, force: true, tag: 'canary' },\n        path: makeProject(),\n      },\n      makeDeps({ spawn: vi.fn().mockResolvedValue({ code: 1 }) }),\n      { runTransforms },\n    )\n\n    expect(runTransforms).not.toHaveBeenCalled()\n    expect(result.failed).toBe(true)\n  })\n\n  it('dry run writes nothing, does not install or transform', async () => {\n    const spawn = vi.fn()\n    const runTransforms = vi.fn()\n\n    await runUpgrade(\n      { flags: { dry: true, force: true, tag: 'canary' }, path: makeProject() },\n      makeDeps({ spawn }),\n      { runTransforms },\n    )\n\n    expect(spawn).not.toHaveBeenCalled()\n    expect(runTransforms).not.toHaveBeenCalled()\n  })\n})\n"],"names":["existsSync","mkdtempSync","writeFileSync","tmpdir","join","describe","expect","it","vi","runUpgrade","packuments","canary","versions","peerDependencies","next","payload","engines","node","makeDeps","overrides","exists","fetchRegistry","name","Promise","resolve","spawn","fn","mockResolvedValue","code","makeProject","dir","JSON","stringify","dependencies","order","mockImplementation","push","runTransforms","failed","results","flags","dry","force","tag","path","toEqual","result","not","toHaveBeenCalled","toBe"],"mappings":"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"}

package/dist/upgrade/packaging.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=packaging.spec.d.ts.map

package/dist/upgrade/packaging.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"packaging.spec.d.ts","sourceRoot":"","sources":["../../src/upgrade/packaging.spec.ts"],"names":[],"mappings":""}

package/dist/upgrade/packaging.spec.js

@@ -1,29 +0,0 @@
-import { execFileSync } from 'node:child_process';
-import { existsSync, mkdtempSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { describe, expect, it } from 'vitest';
-const here = dirname(fileURLToPath(import.meta.url));
-const pkgDir = join(here, '..', '..');
-describe('runbook packaging', ()=>{
-    it('ships the hand-written runbook in src', ()=>{
-        expect(existsSync(join(here, '..', 'runbook', 'payload-v4-upgrade.md'))).toBe(true);
-    });
-    it('copy script places the runbook and v4.mdx into the target runbook dir', ()=>{
-        const scratch = mkdtempSync(join(tmpdir(), 'codemod-pkg-'));
-        // Redirect the copy script's dist target so this test never touches the real dist/.
-        execFileSync('node', [
-            join(pkgDir, 'scripts', 'copy-migration-guide.mjs')
-        ], {
-            env: {
-                ...process.env,
-                CODEMOD_DIST_DIR: scratch
-            }
-        });
-        expect(existsSync(join(scratch, 'runbook', 'payload-v4-upgrade.md'))).toBe(true);
-        expect(existsSync(join(scratch, 'runbook', 'v4.mdx'))).toBe(true);
-    });
-});
-
-//# sourceMappingURL=packaging.spec.js.map

package/dist/upgrade/packaging.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/upgrade/packaging.spec.ts"],"sourcesContent":["import { execFileSync } from 'node:child_process'\nimport { existsSync, mkdtempSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport { describe, expect, it } from 'vitest'\n\nconst here = dirname(fileURLToPath(import.meta.url))\nconst pkgDir = join(here, '..', '..')\n\ndescribe('runbook packaging', () => {\n  it('ships the hand-written runbook in src', () => {\n    expect(existsSync(join(here, '..', 'runbook', 'payload-v4-upgrade.md'))).toBe(true)\n  })\n\n  it('copy script places the runbook and v4.mdx into the target runbook dir', () => {\n    const scratch = mkdtempSync(join(tmpdir(), 'codemod-pkg-'))\n\n    // Redirect the copy script's dist target so this test never touches the real dist/.\n    execFileSync('node', [join(pkgDir, 'scripts', 'copy-migration-guide.mjs')], {\n      env: { ...process.env, CODEMOD_DIST_DIR: scratch },\n    })\n\n    expect(existsSync(join(scratch, 'runbook', 'payload-v4-upgrade.md'))).toBe(true)\n    expect(existsSync(join(scratch, 'runbook', 'v4.mdx'))).toBe(true)\n  })\n})\n"],"names":["execFileSync","existsSync","mkdtempSync","tmpdir","dirname","join","fileURLToPath","describe","expect","it","here","url","pkgDir","toBe","scratch","env","process","CODEMOD_DIST_DIR"],"mappings":"AAAA,SAASA,YAAY,QAAQ,qBAAoB;AACjD,SAASC,UAAU,EAAEC,WAAW,QAAQ,UAAS;AACjD,SAASC,MAAM,QAAQ,UAAS;AAChC,SAASC,OAAO,EAAEC,IAAI,QAAQ,YAAW;AACzC,SAASC,aAAa,QAAQ,WAAU;AACxC,SAASC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,SAAQ;AAE7C,MAAMC,OAAON,QAAQE,cAAc,YAAYK,GAAG;AAClD,MAAMC,SAASP,KAAKK,MAAM,MAAM;AAEhCH,SAAS,qBAAqB;IAC5BE,GAAG,yCAAyC;QAC1CD,OAAOP,WAAWI,KAAKK,MAAM,MAAM,WAAW,2BAA2BG,IAAI,CAAC;IAChF;IAEAJ,GAAG,yEAAyE;QAC1E,MAAMK,UAAUZ,YAAYG,KAAKF,UAAU;QAE3C,oFAAoF;QACpFH,aAAa,QAAQ;YAACK,KAAKO,QAAQ,WAAW;SAA4B,EAAE;YAC1EG,KAAK;gBAAE,GAAGC,QAAQD,GAAG;gBAAEE,kBAAkBH;YAAQ;QACnD;QAEAN,OAAOP,WAAWI,KAAKS,SAAS,WAAW,2BAA2BD,IAAI,CAAC;QAC3EL,OAAOP,WAAWI,KAAKS,SAAS,WAAW,YAAYD,IAAI,CAAC;IAC9D;AACF"}

package/dist/upgrade/prompt.d.ts

@@ -1,11 +0,0 @@
-/**
- * Render the overarching agent prompt for a full Payload v3 -> v4 upgrade,
- * Next.js 16 included. The prompt is a thin orchestrator: it sequences the
- * gates, runs this package's `upgrade` command for the deterministic slice,
- * delegates Next.js to Next's own agent workflow, and points at the migration
- * guide for the judgment work rather than restating any of it. The text is
- * static and project-agnostic — the agent runs it from the project root. Pure:
- * the caller prints it.
- */
-export declare function renderUpgradePrompt(): string;
-//# sourceMappingURL=prompt.d.ts.map

package/dist/upgrade/prompt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/upgrade/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAgE5C"}

package/dist/upgrade/prompt.js

@@ -1,75 +0,0 @@
-/**
- * Render the overarching agent prompt for a full Payload v3 -> v4 upgrade,
- * Next.js 16 included. The prompt is a thin orchestrator: it sequences the
- * gates, runs this package's `upgrade` command for the deterministic slice,
- * delegates Next.js to Next's own agent workflow, and points at the migration
- * guide for the judgment work rather than restating any of it. The text is
- * static and project-agnostic — the agent runs it from the project root. Pure:
- * the caller prints it.
- */ export function renderUpgradePrompt() {
-    return `You are upgrading this project from Payload v3 to v4, Next.js 16 included.
-
-Ground rule: resolution over intent. A step is done only when it installs, builds, and boots.
-Never report a task complete because the edit looks right — confirm it. A silent gap reads as
-"checked and fine".
-
-## 0. Preconditions
-- Work on a clean git tree or a fresh branch.
-- Use Node >=24.15 (the exact engines floor is printed by the command in step 2).
-
-## 1. Pre-upgrade migrations (do these on v3, before touching versions)
-Some migrations need the v3 tooling that v4 deletes, so they MUST run before the upgrade:
-- Slate richtext is removed in v4. Migrate Slate -> Lexical while still on v3; the migration path
-  is gone once the packages are pinned to v4.
-
-Do not proceed to step 2 until these are complete and committed.
-
-## 2. Payload mechanical slice
-Run this from the project root:
-
-    npx @payloadcms/codemod upgrade .
-
-Add \`--tag <dist-tag>\` to resolve Payload from a non-default dist-tag (default is \`canary\`).
-This pins the Payload packages to v4, removes conflicting overrides, writes the toolchain
-floors, installs, and runs the AST transforms. Read its report:
-- It prints the resolved payload version, the required Next target, and the path to the
-  bundled runbook and migration guide. Use those paths below.
-- The unmet \`@payloadcms/next\` peer against Next 15 is EXPECTED at this point. Do NOT downgrade
-  payload to satisfy it — step 3 resolves it by upgrading Next.
-- Do not hand-edit the versions it pinned.
-
-## 3. Next.js 16 (delegate to Next's workflow)
-Payload v4 requires Next 16. The command above did not touch Next. Run Next's own recommended
-agent workflow, which bumps Next + React and migrates the code as one unit:
-<https://nextjs.org/docs/app/guides/upgrading/version-16#use-an-ai-agent-recommended>
-
-In short: run \`npx @next/codemod@canary upgrade latest\`, then
-\`npx @next/codemod@canary next-async-request-api .\`, and follow Next's AGENTS.md workflow for
-the rest. Keep the result within the Next target range printed in step 2's report. Reinstall
-afterward so the \`@payloadcms/next\` peer resolves.
-
-## 4. Regenerate generated files
-\`payload generate:types && payload generate:importmap\`. Never hand-edit \`payload-types.ts\` or
-\`importMap.js\` — regenerate them.
-
-## 5. Fix-forward judgment work (against the now-v4 tree)
-These depend on the v4 APIs and types existing, so they follow the upgrade. Open the bundled
-migration guide (\`v4.mdx\`, path printed in step 2) and the bundled runbook
-(\`runbook/payload-v4-upgrade.md\`) and work the items they list — SCSS -> CSS and \`--theme-*\` ->
-\`--color-*\` token renames, Lexical union type-narrowing, jobs DB migrations, strict cron parsing,
-and anything flagged in the per-transform notes. Consult the guide for each; do not guess from
-memory.
-
-## 6. Verify
-- \`tsc --noEmit\` (delete \`tsconfig.tsbuildinfo\` first; set \`checkJs: true\` so \`importMap.js\` is covered).
-- Run integration and e2e tests separately.
-- Build.
-- Confirm native modules (e.g. \`sharp\`) still load.
-
-## 7. Report
-Distinguish verified, cannot-confirm, and broken. Do not call the upgrade complete while any
-gate fails or any generated file is stale.
-`;
-}
-
-//# sourceMappingURL=prompt.js.map