@payloadcms/codemod 4.0.0-internal.167c7cd → 4.0.0-internal.2f0d313

package/dist/upgrade/rewritePackageJson.js

@@ -0,0 +1,106 @@
+const DEP_FIELDS = [
+    'dependencies',
+    'devDependencies'
+];
+export const isPayloadPackage = (name)=>name === 'payload' || name.startsWith('@payloadcms/');
+/**
+ * The `@payloadcms/eslint-*` packages are versioned independently of the core
+ * payload packages, so they are tracked on `latest` rather than lockstep-pinned.
+ */ export const isPayloadEslintPackage = (name)=>name.startsWith('@payloadcms/eslint');
+/**
+ * Mutate `data` in place for a v4 upgrade: exact-pin payload packages, drop
+ * payload dependency overrides, and write the toolchain floors. Never touches
+ * next/react — the Next.js upgrade is delegated to Next's own workflow.
+ * Returns a summary for the report. Idempotent.
+ */ export function rewritePackageJson({ data, resolved }) {
+    const pinnedPayload = pinPayloadPackages(data, resolved.payloadVersion);
+    const overridesRemoved = removePayloadOverrides(data);
+    const floorsWritten = writeFloors(data, resolved);
+    return {
+        floorsWritten,
+        overridesRemoved,
+        pinnedPayload
+    };
+}
+function pinPayloadPackages(data, version) {
+    const pinned = [];
+    for (const field of DEP_FIELDS){
+        const deps = data[field];
+        if (!isRecord(deps)) {
+            continue;
+        }
+        for (const name of Object.keys(deps)){
+            if (isPayloadEslintPackage(name)) {
+                deps[name] = 'latest';
+                continue;
+            }
+            if (isPayloadPackage(name)) {
+                deps[name] = version;
+                pinned.push(name);
+            }
+        }
+    }
+    return pinned;
+}
+function removePayloadOverrides(data) {
+    const removed = [];
+    const pnpm = data.pnpm;
+    if (isRecord(pnpm) && isRecord(pnpm.overrides)) {
+        pruneOverrideBlock(pnpm.overrides, 'pnpm.overrides', removed);
+        if (Object.keys(pnpm.overrides).length === 0) {
+            delete pnpm.overrides;
+        }
+        if (Object.keys(pnpm).length === 0) {
+            delete data.pnpm;
+        }
+    }
+    for (const key of [
+        'overrides',
+        'resolutions'
+    ]){
+        const block = data[key];
+        if (isRecord(block)) {
+            pruneOverrideBlock(block, key, removed);
+            if (Object.keys(block).length === 0) {
+                delete data[key];
+            }
+        }
+    }
+    return removed;
+}
+function pruneOverrideBlock(block, label, removed) {
+    for (const name of Object.keys(block)){
+        if (isPayloadPackage(name)) {
+            delete block[name];
+            removed.push(`${label}.${name}`);
+        }
+    }
+}
+function writeFloors(data, resolved) {
+    const written = [];
+    pinDep(data, 'typescript', resolved.typescript);
+    pinDep(data, '@types/node', resolved.typesNode);
+    written.push('typescript', '@types/node');
+    const engines = isRecord(data.engines) ? data.engines : {};
+    engines.node = resolved.enginesNode;
+    data.engines = engines;
+    written.push('engines.node');
+    return written;
+}
+/** Update a dep wherever it already lives, else add it to devDependencies. */ function pinDep(data, name, version) {
+    for (const field of DEP_FIELDS){
+        const deps = data[field];
+        if (isRecord(deps) && name in deps) {
+            deps[name] = version;
+            return;
+        }
+    }
+    const devDeps = isRecord(data.devDependencies) ? data.devDependencies : {};
+    devDeps[name] = version;
+    data.devDependencies = devDeps;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+//# sourceMappingURL=rewritePackageJson.js.map

package/dist/upgrade/rewritePackageJson.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/rewritePackageJson.ts"],"sourcesContent":["import type { ResolvedVersions } from './types.js'\n\ntype RewriteArgs = {\n  data: Record<string, unknown>\n  resolved: ResolvedVersions\n}\n\nexport type RewriteSummary = {\n  floorsWritten: string[]\n  overridesRemoved: string[]\n  pinnedPayload: string[]\n}\n\nconst DEP_FIELDS = ['dependencies', 'devDependencies'] as const\n\nexport const isPayloadPackage = (name: string): boolean =>\n  name === 'payload' || name.startsWith('@payloadcms/')\n\n/**\n * The `@payloadcms/eslint-*` packages are versioned independently of the core\n * payload packages, so they are tracked on `latest` rather than lockstep-pinned.\n */\nexport const isPayloadEslintPackage = (name: string): boolean =>\n  name.startsWith('@payloadcms/eslint')\n\n/**\n * Mutate `data` in place for a v4 upgrade: exact-pin payload packages, drop\n * payload dependency overrides, and write the toolchain floors. Never touches\n * next/react — the Next.js upgrade is delegated to Next's own workflow.\n * Returns a summary for the report. Idempotent.\n */\nexport function rewritePackageJson({ data, resolved }: RewriteArgs): RewriteSummary {\n  const pinnedPayload = pinPayloadPackages(data, resolved.payloadVersion)\n  const overridesRemoved = removePayloadOverrides(data)\n  const floorsWritten = writeFloors(data, resolved)\n  return { floorsWritten, overridesRemoved, pinnedPayload }\n}\n\nfunction pinPayloadPackages(data: Record<string, unknown>, version: string): string[] {\n  const pinned: string[] = []\n  for (const field of DEP_FIELDS) {\n    const deps = data[field]\n    if (!isRecord(deps)) {\n      continue\n    }\n    for (const name of Object.keys(deps)) {\n      if (isPayloadEslintPackage(name)) {\n        deps[name] = 'latest'\n        continue\n      }\n      if (isPayloadPackage(name)) {\n        deps[name] = version\n        pinned.push(name)\n      }\n    }\n  }\n  return pinned\n}\n\nfunction removePayloadOverrides(data: Record<string, unknown>): string[] {\n  const removed: string[] = []\n\n  const pnpm = data.pnpm\n  if (isRecord(pnpm) && isRecord(pnpm.overrides)) {\n    pruneOverrideBlock(pnpm.overrides, 'pnpm.overrides', removed)\n    if (Object.keys(pnpm.overrides).length === 0) {\n      delete pnpm.overrides\n    }\n    if (Object.keys(pnpm).length === 0) {\n      delete data.pnpm\n    }\n  }\n\n  for (const key of ['overrides', 'resolutions'] as const) {\n    const block = data[key]\n    if (isRecord(block)) {\n      pruneOverrideBlock(block, key, removed)\n      if (Object.keys(block).length === 0) {\n        delete data[key]\n      }\n    }\n  }\n\n  return removed\n}\n\nfunction pruneOverrideBlock(\n  block: Record<string, unknown>,\n  label: string,\n  removed: string[],\n): void {\n  for (const name of Object.keys(block)) {\n    if (isPayloadPackage(name)) {\n      delete block[name]\n      removed.push(`${label}.${name}`)\n    }\n  }\n}\n\nfunction writeFloors(data: Record<string, unknown>, resolved: ResolvedVersions): string[] {\n  const written: string[] = []\n  pinDep(data, 'typescript', resolved.typescript)\n  pinDep(data, '@types/node', resolved.typesNode)\n  written.push('typescript', '@types/node')\n\n  const engines = isRecord(data.engines) ? data.engines : {}\n  engines.node = resolved.enginesNode\n  data.engines = engines\n  written.push('engines.node')\n\n  return written\n}\n\n/** Update a dep wherever it already lives, else add it to devDependencies. */\nfunction pinDep(data: Record<string, unknown>, name: string, version: string): void {\n  for (const field of DEP_FIELDS) {\n    const deps = data[field]\n    if (isRecord(deps) && name in deps) {\n      deps[name] = version\n      return\n    }\n  }\n  const devDeps = isRecord(data.devDependencies) ? data.devDependencies : {}\n  devDeps[name] = version\n  data.devDependencies = devDeps\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n"],"names":["DEP_FIELDS","isPayloadPackage","name","startsWith","isPayloadEslintPackage","rewritePackageJson","data","resolved","pinnedPayload","pinPayloadPackages","payloadVersion","overridesRemoved","removePayloadOverrides","floorsWritten","writeFloors","version","pinned","field","deps","isRecord","Object","keys","push","removed","pnpm","overrides","pruneOverrideBlock","length","key","block","label","written","pinDep","typescript","typesNode","engines","node","enginesNode","devDeps","devDependencies","value","Array","isArray"],"mappings":"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"}

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

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

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

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

package/dist/upgrade/rewritePackageJson.spec.js

@@ -0,0 +1,108 @@
+import { describe, expect, it } from 'vitest';
+import { rewritePackageJson } from './rewritePackageJson.js';
+const resolved = {
+    enginesNode: '>=24.15.0',
+    nextTarget: '16.9.3',
+    payloadVersion: '4.0.0-canary.20',
+    typesNode: '24.12.3',
+    typescript: '6.0.3'
+};
+const baseInput = ()=>({
+        dependencies: {
+            '@payloadcms/next': '^3.0.0',
+            '@payloadcms/ui': '~3.0.0',
+            next: '15.5.0',
+            payload: '^3.0.0',
+            react: '19.0.0'
+        },
+        devDependencies: {
+            '@payloadcms/eslint-config': '^3.0.0',
+            '@payloadcms/eslint-plugin': '^3.0.0',
+            '@types/node': '22.9.0',
+            typescript: '5.7.3'
+        },
+        engines: {
+            node: '>=18.20.2'
+        },
+        pnpm: {
+            overrides: {
+                payload: '3.0.0',
+                'some-other': '1.0.0'
+            }
+        },
+        resolutions: {
+            '@payloadcms/ui': '3.0.0'
+        }
+    });
+describe('rewritePackageJson', ()=>{
+    it('pins payload packages exactly, deletes payload overrides, writes floors, leaves next/react', ()=>{
+        const data = baseInput();
+        const summary = rewritePackageJson({
+            data,
+            resolved
+        });
+        expect(data).toEqual({
+            dependencies: {
+                '@payloadcms/next': '4.0.0-canary.20',
+                '@payloadcms/ui': '4.0.0-canary.20',
+                next: '15.5.0',
+                payload: '4.0.0-canary.20',
+                react: '19.0.0'
+            },
+            devDependencies: {
+                '@payloadcms/eslint-config': 'latest',
+                '@payloadcms/eslint-plugin': 'latest',
+                '@types/node': '24.12.3',
+                typescript: '6.0.3'
+            },
+            engines: {
+                node: '>=24.15.0'
+            },
+            pnpm: {
+                overrides: {
+                    'some-other': '1.0.0'
+                }
+            }
+        });
+        expect(summary.overridesRemoved.sort()).toEqual([
+            'pnpm.overrides.payload',
+            'resolutions.@payloadcms/ui'
+        ].sort());
+        expect(summary.pinnedPayload).toContain('payload');
+        // eslint packages are not lockstep-pinned
+        expect(summary.pinnedPayload).not.toContain('@payloadcms/eslint-config');
+    });
+    it('adds floors to devDependencies when absent', ()=>{
+        const data = {
+            dependencies: {
+                payload: '^3.0.0'
+            }
+        };
+        rewritePackageJson({
+            data,
+            resolved
+        });
+        expect(data.devDependencies).toEqual({
+            '@types/node': '24.12.3',
+            typescript: '6.0.3'
+        });
+        expect(data.engines).toEqual({
+            node: '>=24.15.0'
+        });
+    });
+    it('is idempotent', ()=>{
+        const data = baseInput();
+        rewritePackageJson({
+            data,
+            resolved
+        });
+        const once = JSON.stringify(data);
+        rewritePackageJson({
+            data,
+            resolved
+        });
+        expect(JSON.stringify(data)).toBe(once);
+    });
+});
+
+//# sourceMappingURL=rewritePackageJson.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/rewritePackageJson.spec.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest'\n\nimport type { ResolvedVersions } from './types.js'\n\nimport { rewritePackageJson } from './rewritePackageJson.js'\n\nconst resolved: ResolvedVersions = {\n  enginesNode: '>=24.15.0',\n  nextTarget: '16.9.3',\n  payloadVersion: '4.0.0-canary.20',\n  typesNode: '24.12.3',\n  typescript: '6.0.3',\n}\n\nconst baseInput = () => ({\n  dependencies: {\n    '@payloadcms/next': '^3.0.0',\n    '@payloadcms/ui': '~3.0.0',\n    next: '15.5.0',\n    payload: '^3.0.0',\n    react: '19.0.0',\n  },\n  devDependencies: {\n    '@payloadcms/eslint-config': '^3.0.0',\n    '@payloadcms/eslint-plugin': '^3.0.0',\n    '@types/node': '22.9.0',\n    typescript: '5.7.3',\n  },\n  engines: { node: '>=18.20.2' },\n  pnpm: { overrides: { payload: '3.0.0', 'some-other': '1.0.0' } },\n  resolutions: { '@payloadcms/ui': '3.0.0' },\n})\n\ndescribe('rewritePackageJson', () => {\n  it('pins payload packages exactly, deletes payload overrides, writes floors, leaves next/react', () => {\n    const data = baseInput() as Record<string, unknown>\n\n    const summary = rewritePackageJson({ data, resolved })\n\n    expect(data).toEqual({\n      dependencies: {\n        '@payloadcms/next': '4.0.0-canary.20',\n        '@payloadcms/ui': '4.0.0-canary.20',\n        next: '15.5.0', // untouched\n        payload: '4.0.0-canary.20',\n        react: '19.0.0', // untouched\n      },\n      devDependencies: {\n        '@payloadcms/eslint-config': 'latest', // versioned independently\n        '@payloadcms/eslint-plugin': 'latest', // versioned independently\n        '@types/node': '24.12.3',\n        typescript: '6.0.3',\n      },\n      engines: { node: '>=24.15.0' },\n      pnpm: { overrides: { 'some-other': '1.0.0' } }, // payload override removed, unrelated kept\n      // resolutions removed entirely (only key was a payload package)\n    })\n    expect(summary.overridesRemoved.sort()).toEqual(\n      ['pnpm.overrides.payload', 'resolutions.@payloadcms/ui'].sort(),\n    )\n    expect(summary.pinnedPayload).toContain('payload')\n    // eslint packages are not lockstep-pinned\n    expect(summary.pinnedPayload).not.toContain('@payloadcms/eslint-config')\n  })\n\n  it('adds floors to devDependencies when absent', () => {\n    const data: Record<string, unknown> = { dependencies: { payload: '^3.0.0' } }\n\n    rewritePackageJson({ data, resolved })\n\n    expect(data.devDependencies).toEqual({\n      '@types/node': '24.12.3',\n      typescript: '6.0.3',\n    })\n    expect(data.engines).toEqual({ node: '>=24.15.0' })\n  })\n\n  it('is idempotent', () => {\n    const data = baseInput() as Record<string, unknown>\n\n    rewritePackageJson({ data, resolved })\n    const once = JSON.stringify(data)\n    rewritePackageJson({ data, resolved })\n\n    expect(JSON.stringify(data)).toBe(once)\n  })\n})\n"],"names":["describe","expect","it","rewritePackageJson","resolved","enginesNode","nextTarget","payloadVersion","typesNode","typescript","baseInput","dependencies","next","payload","react","devDependencies","engines","node","pnpm","overrides","resolutions","data","summary","toEqual","overridesRemoved","sort","pinnedPayload","toContain","not","once","JSON","stringify","toBe"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,SAAQ;AAI7C,SAASC,kBAAkB,QAAQ,0BAAyB;AAE5D,MAAMC,WAA6B;IACjCC,aAAa;IACbC,YAAY;IACZC,gBAAgB;IAChBC,WAAW;IACXC,YAAY;AACd;AAEA,MAAMC,YAAY,IAAO,CAAA;QACvBC,cAAc;YACZ,oBAAoB;YACpB,kBAAkB;YAClBC,MAAM;YACNC,SAAS;YACTC,OAAO;QACT;QACAC,iBAAiB;YACf,6BAA6B;YAC7B,6BAA6B;YAC7B,eAAe;YACfN,YAAY;QACd;QACAO,SAAS;YAAEC,MAAM;QAAY;QAC7BC,MAAM;YAAEC,WAAW;gBAAEN,SAAS;gBAAS,cAAc;YAAQ;QAAE;QAC/DO,aAAa;YAAE,kBAAkB;QAAQ;IAC3C,CAAA;AAEApB,SAAS,sBAAsB;IAC7BE,GAAG,8FAA8F;QAC/F,MAAMmB,OAAOX;QAEb,MAAMY,UAAUnB,mBAAmB;YAAEkB;YAAMjB;QAAS;QAEpDH,OAAOoB,MAAME,OAAO,CAAC;YACnBZ,cAAc;gBACZ,oBAAoB;gBACpB,kBAAkB;gBAClBC,MAAM;gBACNC,SAAS;gBACTC,OAAO;YACT;YACAC,iBAAiB;gBACf,6BAA6B;gBAC7B,6BAA6B;gBAC7B,eAAe;gBACfN,YAAY;YACd;YACAO,SAAS;gBAAEC,MAAM;YAAY;YAC7BC,MAAM;gBAAEC,WAAW;oBAAE,cAAc;gBAAQ;YAAE;QAE/C;QACAlB,OAAOqB,QAAQE,gBAAgB,CAACC,IAAI,IAAIF,OAAO,CAC7C;YAAC;YAA0B;SAA6B,CAACE,IAAI;QAE/DxB,OAAOqB,QAAQI,aAAa,EAAEC,SAAS,CAAC;QACxC,0CAA0C;QAC1C1B,OAAOqB,QAAQI,aAAa,EAAEE,GAAG,CAACD,SAAS,CAAC;IAC9C;IAEAzB,GAAG,8CAA8C;QAC/C,MAAMmB,OAAgC;YAAEV,cAAc;gBAAEE,SAAS;YAAS;QAAE;QAE5EV,mBAAmB;YAAEkB;YAAMjB;QAAS;QAEpCH,OAAOoB,KAAKN,eAAe,EAAEQ,OAAO,CAAC;YACnC,eAAe;YACfd,YAAY;QACd;QACAR,OAAOoB,KAAKL,OAAO,EAAEO,OAAO,CAAC;YAAEN,MAAM;QAAY;IACnD;IAEAf,GAAG,iBAAiB;QAClB,MAAMmB,OAAOX;QAEbP,mBAAmB;YAAEkB;YAAMjB;QAAS;QACpC,MAAMyB,OAAOC,KAAKC,SAAS,CAACV;QAC5BlB,mBAAmB;YAAEkB;YAAMjB;QAAS;QAEpCH,OAAO6B,KAAKC,SAAS,CAACV,OAAOW,IAAI,CAACH;IACpC;AACF"}

package/dist/upgrade/runInstall.d.ts

@@ -0,0 +1,16 @@
+import type { PackageManager, Spawn } from './types.js';
+type RunInstallArgs = {
+    packageManager: PackageManager;
+    path: string;
+    spawn: Spawn;
+};
+/**
+ * Install dependencies with the detected package manager. `install` is the same
+ * subcommand across pnpm/npm/yarn/bun. Corepack's interactive download prompt is
+ * disabled so a non-interactive run cannot hang and abort the install.
+ */
+export declare function runInstall({ packageManager, path, spawn, }: RunInstallArgs): Promise<{
+    code: number;
+}>;
+export {};
+//# sourceMappingURL=runInstall.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runInstall.d.ts","sourceRoot":"","sources":["../../src/upgrade/runInstall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvD,KAAK,cAAc,GAAG;IACpB,cAAc,EAAE,cAAc,CAAA;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EACzB,cAAc,EACd,IAAI,EACJ,KAAK,GACN,EAAE,cAAc,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAK5C"}

package/dist/upgrade/runInstall.js

@@ -0,0 +1,17 @@
+/**
+ * Install dependencies with the detected package manager. `install` is the same
+ * subcommand across pnpm/npm/yarn/bun. Corepack's interactive download prompt is
+ * disabled so a non-interactive run cannot hang and abort the install.
+ */ export function runInstall({ packageManager, path, spawn }) {
+    return spawn(packageManager, [
+        'install'
+    ], {
+        cwd: path,
+        env: {
+            ...process.env,
+            COREPACK_ENABLE_DOWNLOAD_PROMPT: '0'
+        }
+    });
+}
+
+//# sourceMappingURL=runInstall.js.map

package/dist/upgrade/runInstall.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/runInstall.ts"],"sourcesContent":["import type { PackageManager, Spawn } from './types.js'\n\ntype RunInstallArgs = {\n  packageManager: PackageManager\n  path: string\n  spawn: Spawn\n}\n\n/**\n * Install dependencies with the detected package manager. `install` is the same\n * subcommand across pnpm/npm/yarn/bun. Corepack's interactive download prompt is\n * disabled so a non-interactive run cannot hang and abort the install.\n */\nexport function runInstall({\n  packageManager,\n  path,\n  spawn,\n}: RunInstallArgs): Promise<{ code: number }> {\n  return spawn(packageManager, ['install'], {\n    cwd: path,\n    env: { ...process.env, COREPACK_ENABLE_DOWNLOAD_PROMPT: '0' },\n  })\n}\n"],"names":["runInstall","packageManager","path","spawn","cwd","env","process","COREPACK_ENABLE_DOWNLOAD_PROMPT"],"mappings":"AAQA;;;;CAIC,GACD,OAAO,SAASA,WAAW,EACzBC,cAAc,EACdC,IAAI,EACJC,KAAK,EACU;IACf,OAAOA,MAAMF,gBAAgB;QAAC;KAAU,EAAE;QACxCG,KAAKF;QACLG,KAAK;YAAE,GAAGC,QAAQD,GAAG;YAAEE,iCAAiC;QAAI;IAC9D;AACF"}

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

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

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

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

package/dist/upgrade/runInstall.spec.js

@@ -0,0 +1,48 @@
+import { describe, expect, it, vi } from 'vitest';
+import { runInstall } from './runInstall.js';
+describe('runInstall', ()=>{
+    it('invokes the detected package manager install with corepack prompt disabled', async ()=>{
+        const spawn = vi.fn().mockResolvedValue({
+            code: 0
+        });
+        const result = await runInstall({
+            packageManager: 'pnpm',
+            path: '/project',
+            spawn
+        });
+        expect(result).toEqual({
+            code: 0
+        });
+        expect(spawn).toHaveBeenCalledWith('pnpm', [
+            'install'
+        ], {
+            cwd: '/project',
+            env: expect.objectContaining({
+                COREPACK_ENABLE_DOWNLOAD_PROMPT: '0'
+            })
+        });
+    });
+    it('uses the right binary for each package manager', async ()=>{
+        const spawn = vi.fn().mockResolvedValue({
+            code: 0
+        });
+        for (const pm of [
+            'npm',
+            'yarn',
+            'bun'
+        ]){
+            await runInstall({
+                packageManager: pm,
+                path: '/p',
+                spawn
+            });
+        }
+        expect(spawn.mock.calls.map((c)=>c[0])).toEqual([
+            'npm',
+            'yarn',
+            'bun'
+        ]);
+    });
+});
+
+//# sourceMappingURL=runInstall.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/runInstall.spec.ts"],"sourcesContent":["import { describe, expect, it, vi } from 'vitest'\n\nimport { runInstall } from './runInstall.js'\n\ndescribe('runInstall', () => {\n  it('invokes the detected package manager install with corepack prompt disabled', async () => {\n    const spawn = vi.fn().mockResolvedValue({ code: 0 })\n\n    const result = await runInstall({ packageManager: 'pnpm', path: '/project', spawn })\n\n    expect(result).toEqual({ code: 0 })\n    expect(spawn).toHaveBeenCalledWith('pnpm', ['install'], {\n      cwd: '/project',\n      env: expect.objectContaining({ COREPACK_ENABLE_DOWNLOAD_PROMPT: '0' }),\n    })\n  })\n\n  it('uses the right binary for each package manager', async () => {\n    const spawn = vi.fn().mockResolvedValue({ code: 0 })\n\n    for (const pm of ['npm', 'yarn', 'bun'] as const) {\n      await runInstall({ packageManager: pm, path: '/p', spawn })\n    }\n\n    expect(spawn.mock.calls.map((c) => c[0])).toEqual(['npm', 'yarn', 'bun'])\n  })\n})\n"],"names":["describe","expect","it","vi","runInstall","spawn","fn","mockResolvedValue","code","result","packageManager","path","toEqual","toHaveBeenCalledWith","cwd","env","objectContaining","COREPACK_ENABLE_DOWNLOAD_PROMPT","pm","mock","calls","map","c"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,EAAEC,EAAE,QAAQ,SAAQ;AAEjD,SAASC,UAAU,QAAQ,kBAAiB;AAE5CJ,SAAS,cAAc;IACrBE,GAAG,8EAA8E;QAC/E,MAAMG,QAAQF,GAAGG,EAAE,GAAGC,iBAAiB,CAAC;YAAEC,MAAM;QAAE;QAElD,MAAMC,SAAS,MAAML,WAAW;YAAEM,gBAAgB;YAAQC,MAAM;YAAYN;QAAM;QAElFJ,OAAOQ,QAAQG,OAAO,CAAC;YAAEJ,MAAM;QAAE;QACjCP,OAAOI,OAAOQ,oBAAoB,CAAC,QAAQ;YAAC;SAAU,EAAE;YACtDC,KAAK;YACLC,KAAKd,OAAOe,gBAAgB,CAAC;gBAAEC,iCAAiC;YAAI;QACtE;IACF;IAEAf,GAAG,kDAAkD;QACnD,MAAMG,QAAQF,GAAGG,EAAE,GAAGC,iBAAiB,CAAC;YAAEC,MAAM;QAAE;QAElD,KAAK,MAAMU,MAAM;YAAC;YAAO;YAAQ;SAAM,CAAW;YAChD,MAAMd,WAAW;gBAAEM,gBAAgBQ;gBAAIP,MAAM;gBAAMN;YAAM;QAC3D;QAEAJ,OAAOI,MAAMc,IAAI,CAACC,KAAK,CAACC,GAAG,CAAC,CAACC,IAAMA,CAAC,CAAC,EAAE,GAAGV,OAAO,CAAC;YAAC;YAAO;YAAQ;SAAM;IAC1E;AACF"}

package/dist/upgrade/types.d.ts

@@ -0,0 +1,42 @@
+/** Minimal shape of an npm registry packument we read. */
+export type RegistryPackument = {
+    'dist-tags'?: Record<string, string>;
+    versions?: Record<string, {
+        engines?: Record<string, string>;
+        peerDependencies?: Record<string, string>;
+    }>;
+};
+export type FetchRegistry = (packageName: string) => Promise<RegistryPackument>;
+export type Spawn = (command: string, args: string[], options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}) => Promise<{
+    code: number;
+}>;
+export type PackageManager = 'bun' | 'npm' | 'pnpm' | 'yarn';
+/** Target versions the command resolves. Only some are written; see `written`. */
+export type ResolvedVersions = {
+    /** Copied verbatim into engines.node. */
+    enginesNode: string;
+    /** Newest patch within @payloadcms/next's peer range. REPORT ONLY, never written. */
+    nextTarget: null | string;
+    /** Exact canary, applied in lockstep to payload + every @payloadcms/*. */
+    payloadVersion: string;
+    /** TypeScript floor (guide-sourced constant). */
+    typescript: string;
+    /** Newest @types/node patch within the Node major. */
+    typesNode: string;
+};
+export type UpgradeDeps = {
+    exists: (path: string) => boolean;
+    fetchRegistry: FetchRegistry;
+    spawn: Spawn;
+};
+/**
+ * TypeScript floor for Payload v4. Nothing machine-readable declares it, so it
+ * lives here, sourced from the v4 migration guide prose. Bump alongside the guide.
+ */
+export declare const TS_FLOOR = "6.0.3";
+/** Path (relative to dist/) of the bundled runbook the command points users to. */
+export declare const RUNBOOK_RELATIVE_PATH = "runbook/payload-v4-upgrade.md";
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/upgrade/types.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,QAAQ,CAAC,EAAE,MAAM,CACf,MAAM,EACN;QACE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAC1C,CACF,CAAA;CACF,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAA;AAE/E,MAAM,MAAM,KAAK,GAAG,CAClB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAC7C,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAE9B,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;AAE5D,kFAAkF;AAClF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,qFAAqF;IACrF,UAAU,EAAE,IAAI,GAAG,MAAM,CAAA;IACzB,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IACjC,aAAa,EAAE,aAAa,CAAA;IAC5B,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,UAAU,CAAA;AAE/B,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,kCAAkC,CAAA"}

package/dist/upgrade/types.js

@@ -0,0 +1,7 @@
+/** Minimal shape of an npm registry packument we read. */ /**
+ * TypeScript floor for Payload v4. Nothing machine-readable declares it, so it
+ * lives here, sourced from the v4 migration guide prose. Bump alongside the guide.
+ */ export const TS_FLOOR = '6.0.3';
+/** Path (relative to dist/) of the bundled runbook the command points users to. */ export const RUNBOOK_RELATIVE_PATH = 'runbook/payload-v4-upgrade.md';
+
+//# sourceMappingURL=types.js.map

package/dist/upgrade/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/types.ts"],"sourcesContent":["/** Minimal shape of an npm registry packument we read. */\nexport type RegistryPackument = {\n  'dist-tags'?: Record<string, string>\n  versions?: Record<\n    string,\n    {\n      engines?: Record<string, string>\n      peerDependencies?: Record<string, string>\n    }\n  >\n}\n\nexport type FetchRegistry = (packageName: string) => Promise<RegistryPackument>\n\nexport type Spawn = (\n  command: string,\n  args: string[],\n  options: { cwd: string; env: NodeJS.ProcessEnv },\n) => Promise<{ code: number }>\n\nexport type PackageManager = 'bun' | 'npm' | 'pnpm' | 'yarn'\n\n/** Target versions the command resolves. Only some are written; see `written`. */\nexport type ResolvedVersions = {\n  /** Copied verbatim into engines.node. */\n  enginesNode: string\n  /** Newest patch within @payloadcms/next's peer range. REPORT ONLY, never written. */\n  nextTarget: null | string\n  /** Exact canary, applied in lockstep to payload + every @payloadcms/*. */\n  payloadVersion: string\n  /** TypeScript floor (guide-sourced constant). */\n  typescript: string\n  /** Newest @types/node patch within the Node major. */\n  typesNode: string\n}\n\nexport type UpgradeDeps = {\n  exists: (path: string) => boolean\n  fetchRegistry: FetchRegistry\n  spawn: Spawn\n}\n\n/**\n * TypeScript floor for Payload v4. Nothing machine-readable declares it, so it\n * lives here, sourced from the v4 migration guide prose. Bump alongside the guide.\n */\nexport const TS_FLOOR = '6.0.3'\n\n/** Path (relative to dist/) of the bundled runbook the command points users to. */\nexport const RUNBOOK_RELATIVE_PATH = 'runbook/payload-v4-upgrade.md'\n"],"names":["TS_FLOOR","RUNBOOK_RELATIVE_PATH"],"mappings":"AAAA,wDAAwD,GA0CxD;;;CAGC,GACD,OAAO,MAAMA,WAAW,QAAO;AAE/B,iFAAiF,GACjF,OAAO,MAAMC,wBAAwB,gCAA+B"}

package/dist/utils/project.d.ts

@@ -0,0 +1,4 @@
+import { Project } from 'ts-morph';
+/** Load a ts-morph Project rooted at `path`, using its tsconfig.json if present. */
+export declare function loadProject(path: string): Project;
+//# sourceMappingURL=project.d.ts.map

package/dist/utils/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/utils/project.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,OAAO,EAAa,MAAM,UAAU,CAAA;AAE9D,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAmBjD"}

package/dist/utils/project.js

@@ -0,0 +1,30 @@
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { IndentationText, Project, QuoteKind } from 'ts-morph';
+/** Load a ts-morph Project rooted at `path`, using its tsconfig.json if present. */ export function loadProject(path) {
+    const manipulationSettings = {
+        indentationText: IndentationText.TwoSpaces,
+        quoteKind: QuoteKind.Single,
+        useTrailingCommas: true
+    };
+    const tsconfigPath = resolve(path, 'tsconfig.json');
+    if (existsSync(tsconfigPath)) {
+        return new Project({
+            manipulationSettings,
+            tsConfigFilePath: tsconfigPath
+        });
+    }
+    const project = new Project({
+        manipulationSettings
+    });
+    project.addSourceFilesAtPaths([
+        `${path}/**/*.{ts,tsx,js,jsx}`,
+        '!**/node_modules/**',
+        '!**/dist/**',
+        '!**/.next/**',
+        '!**/build/**'
+    ]);
+    return project;
+}
+
+//# sourceMappingURL=project.js.map

package/dist/utils/project.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/project.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { resolve } from 'node:path'\nimport { IndentationText, Project, QuoteKind } from 'ts-morph'\n\n/** Load a ts-morph Project rooted at `path`, using its tsconfig.json if present. */\nexport function loadProject(path: string): Project {\n  const manipulationSettings = {\n    indentationText: IndentationText.TwoSpaces,\n    quoteKind: QuoteKind.Single,\n    useTrailingCommas: true,\n  }\n  const tsconfigPath = resolve(path, 'tsconfig.json')\n  if (existsSync(tsconfigPath)) {\n    return new Project({ manipulationSettings, tsConfigFilePath: tsconfigPath })\n  }\n  const project = new Project({ manipulationSettings })\n  project.addSourceFilesAtPaths([\n    `${path}/**/*.{ts,tsx,js,jsx}`,\n    '!**/node_modules/**',\n    '!**/dist/**',\n    '!**/.next/**',\n    '!**/build/**',\n  ])\n  return project\n}\n"],"names":["existsSync","resolve","IndentationText","Project","QuoteKind","loadProject","path","manipulationSettings","indentationText","TwoSpaces","quoteKind","Single","useTrailingCommas","tsconfigPath","tsConfigFilePath","project","addSourceFilesAtPaths"],"mappings":"AAAA,SAASA,UAAU,QAAQ,UAAS;AACpC,SAASC,OAAO,QAAQ,YAAW;AACnC,SAASC,eAAe,EAAEC,OAAO,EAAEC,SAAS,QAAQ,WAAU;AAE9D,kFAAkF,GAClF,OAAO,SAASC,YAAYC,IAAY;IACtC,MAAMC,uBAAuB;QAC3BC,iBAAiBN,gBAAgBO,SAAS;QAC1CC,WAAWN,UAAUO,MAAM;QAC3BC,mBAAmB;IACrB;IACA,MAAMC,eAAeZ,QAAQK,MAAM;IACnC,IAAIN,WAAWa,eAAe;QAC5B,OAAO,IAAIV,QAAQ;YAAEI;YAAsBO,kBAAkBD;QAAa;IAC5E;IACA,MAAME,UAAU,IAAIZ,QAAQ;QAAEI;IAAqB;IACnDQ,QAAQC,qBAAqB,CAAC;QAC5B,GAAGV,KAAK,qBAAqB,CAAC;QAC9B;QACA;QACA;QACA;KACD;IACD,OAAOS;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/codemod",
-  "version": "4.0.0-internal.167c7cd",
+  "version": "4.0.0-internal.2f0d313",
   "description": "Codemods for migrating Payload projects across versions.",
   "homepage": "https://payloadcms.com",
   "repository": {
@@ -29,11 +29,13 @@
     "README.md"
   ],
   "dependencies": {
+    "semver": "^7.8.5",
     "ts-morph": "^21.0.1"
   },
   "devDependencies": {
     "@swc/core": "1.15.3",
     "@types/node": "24.12.3",
+    "@types/semver": "^7.7.1",
     "rimraf": "6.0.1",
     "typescript": "6.0.3",
     "vitest": "4.1.6"
@@ -42,7 +44,8 @@
     "node": ">=24.15.0"
   },
   "scripts": {
-    "build": "pnpm typecheck && pnpm build:swc",
+    "build": "pnpm typecheck && pnpm build:swc && pnpm build:copy-docs",
+    "build:copy-docs": "node scripts/copy-migration-guide.mjs",
     "build:swc": "swc ./src -d ./dist --config-file .swcrc --strip-leading-paths",
     "clean": "rimraf -g {dist,*.tsbuildinfo}",
     "lint": "eslint .",