@payloadcms/codemod 4.0.0-internal.164164a → 4.0.0-internal.2f0d313

package/dist/upgrade/prompt.js

@@ -0,0 +1,75 @@
+/**
+ * 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

package/dist/upgrade/prompt.js.map

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

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

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

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

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

package/dist/upgrade/prompt.spec.js

@@ -0,0 +1,51 @@
+import { describe, expect, it } from 'vitest';
+import { renderUpgradePrompt } from './prompt.js';
+describe('renderUpgradePrompt', ()=>{
+    it('emits a project-agnostic upgrade command', ()=>{
+        const out = renderUpgradePrompt();
+        expect(out).toContain('npx @payloadcms/codemod upgrade .');
+    });
+    it('documents --tag as an inline option rather than baking a value', ()=>{
+        const out = renderUpgradePrompt();
+        expect(out).toContain('--tag <dist-tag>');
+    });
+    it('orders the steps: pre-upgrade before payload slice before Next before verify', ()=>{
+        const out = renderUpgradePrompt();
+        const preUpgradeStep = out.indexOf('## 1. Pre-upgrade migrations');
+        const payloadStep = out.indexOf('## 2. Payload mechanical slice');
+        const nextStep = out.indexOf('## 3. Next.js 16');
+        const verifyStep = out.indexOf('## 6. Verify');
+        expect(preUpgradeStep).toBeGreaterThan(-1);
+        expect(preUpgradeStep).toBeLessThan(payloadStep);
+        expect(payloadStep).toBeLessThan(nextStep);
+        expect(nextStep).toBeLessThan(verifyStep);
+    });
+    it('places Slate -> Lexical in the pre-upgrade gate, not the post-upgrade work', ()=>{
+        const out = renderUpgradePrompt();
+        const slate = out.indexOf('Slate -> Lexical');
+        const mechanicalSlice = out.indexOf('## 2. Payload mechanical slice');
+        expect(slate).toBeGreaterThan(-1);
+        expect(slate).toBeLessThan(mechanicalSlice);
+    });
+    it('delegates Next.js to Next own codemods rather than restating them', ()=>{
+        const out = renderUpgradePrompt();
+        expect(out).toContain('@next/codemod@canary upgrade latest');
+        expect(out).toContain('next-async-request-api');
+    });
+    it('encodes the expected-unmet-peer invariant', ()=>{
+        const out = renderUpgradePrompt();
+        expect(out).toContain('EXPECTED');
+        expect(out).toMatch(/do not downgrade\s+payload/i);
+    });
+    it('points at the migration guide and runbook without duplicating them', ()=>{
+        const out = renderUpgradePrompt();
+        expect(out).toContain('v4.mdx');
+        expect(out).toContain('runbook/payload-v4-upgrade.md');
+    });
+    it('contains no figma references', ()=>{
+        const out = renderUpgradePrompt();
+        expect(out.toLowerCase()).not.toContain('figma');
+    });
+});
+
+//# sourceMappingURL=prompt.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/prompt.spec.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest'\n\nimport { renderUpgradePrompt } from './prompt.js'\n\ndescribe('renderUpgradePrompt', () => {\n  it('emits a project-agnostic upgrade command', () => {\n    const out = renderUpgradePrompt()\n\n    expect(out).toContain('npx @payloadcms/codemod upgrade .')\n  })\n\n  it('documents --tag as an inline option rather than baking a value', () => {\n    const out = renderUpgradePrompt()\n\n    expect(out).toContain('--tag <dist-tag>')\n  })\n\n  it('orders the steps: pre-upgrade before payload slice before Next before verify', () => {\n    const out = renderUpgradePrompt()\n    const preUpgradeStep = out.indexOf('## 1. Pre-upgrade migrations')\n    const payloadStep = out.indexOf('## 2. Payload mechanical slice')\n    const nextStep = out.indexOf('## 3. Next.js 16')\n    const verifyStep = out.indexOf('## 6. Verify')\n\n    expect(preUpgradeStep).toBeGreaterThan(-1)\n    expect(preUpgradeStep).toBeLessThan(payloadStep)\n    expect(payloadStep).toBeLessThan(nextStep)\n    expect(nextStep).toBeLessThan(verifyStep)\n  })\n\n  it('places Slate -> Lexical in the pre-upgrade gate, not the post-upgrade work', () => {\n    const out = renderUpgradePrompt()\n    const slate = out.indexOf('Slate -> Lexical')\n    const mechanicalSlice = out.indexOf('## 2. Payload mechanical slice')\n\n    expect(slate).toBeGreaterThan(-1)\n    expect(slate).toBeLessThan(mechanicalSlice)\n  })\n\n  it('delegates Next.js to Next own codemods rather than restating them', () => {\n    const out = renderUpgradePrompt()\n\n    expect(out).toContain('@next/codemod@canary upgrade latest')\n    expect(out).toContain('next-async-request-api')\n  })\n\n  it('encodes the expected-unmet-peer invariant', () => {\n    const out = renderUpgradePrompt()\n\n    expect(out).toContain('EXPECTED')\n    expect(out).toMatch(/do not downgrade\\s+payload/i)\n  })\n\n  it('points at the migration guide and runbook without duplicating them', () => {\n    const out = renderUpgradePrompt()\n\n    expect(out).toContain('v4.mdx')\n    expect(out).toContain('runbook/payload-v4-upgrade.md')\n  })\n\n  it('contains no figma references', () => {\n    const out = renderUpgradePrompt()\n\n    expect(out.toLowerCase()).not.toContain('figma')\n  })\n})\n"],"names":["describe","expect","it","renderUpgradePrompt","out","toContain","preUpgradeStep","indexOf","payloadStep","nextStep","verifyStep","toBeGreaterThan","toBeLessThan","slate","mechanicalSlice","toMatch","toLowerCase","not"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,SAAQ;AAE7C,SAASC,mBAAmB,QAAQ,cAAa;AAEjDH,SAAS,uBAAuB;IAC9BE,GAAG,4CAA4C;QAC7C,MAAME,MAAMD;QAEZF,OAAOG,KAAKC,SAAS,CAAC;IACxB;IAEAH,GAAG,kEAAkE;QACnE,MAAME,MAAMD;QAEZF,OAAOG,KAAKC,SAAS,CAAC;IACxB;IAEAH,GAAG,gFAAgF;QACjF,MAAME,MAAMD;QACZ,MAAMG,iBAAiBF,IAAIG,OAAO,CAAC;QACnC,MAAMC,cAAcJ,IAAIG,OAAO,CAAC;QAChC,MAAME,WAAWL,IAAIG,OAAO,CAAC;QAC7B,MAAMG,aAAaN,IAAIG,OAAO,CAAC;QAE/BN,OAAOK,gBAAgBK,eAAe,CAAC,CAAC;QACxCV,OAAOK,gBAAgBM,YAAY,CAACJ;QACpCP,OAAOO,aAAaI,YAAY,CAACH;QACjCR,OAAOQ,UAAUG,YAAY,CAACF;IAChC;IAEAR,GAAG,8EAA8E;QAC/E,MAAME,MAAMD;QACZ,MAAMU,QAAQT,IAAIG,OAAO,CAAC;QAC1B,MAAMO,kBAAkBV,IAAIG,OAAO,CAAC;QAEpCN,OAAOY,OAAOF,eAAe,CAAC,CAAC;QAC/BV,OAAOY,OAAOD,YAAY,CAACE;IAC7B;IAEAZ,GAAG,qEAAqE;QACtE,MAAME,MAAMD;QAEZF,OAAOG,KAAKC,SAAS,CAAC;QACtBJ,OAAOG,KAAKC,SAAS,CAAC;IACxB;IAEAH,GAAG,6CAA6C;QAC9C,MAAME,MAAMD;QAEZF,OAAOG,KAAKC,SAAS,CAAC;QACtBJ,OAAOG,KAAKW,OAAO,CAAC;IACtB;IAEAb,GAAG,sEAAsE;QACvE,MAAME,MAAMD;QAEZF,OAAOG,KAAKC,SAAS,CAAC;QACtBJ,OAAOG,KAAKC,SAAS,CAAC;IACxB;IAEAH,GAAG,gCAAgC;QACjC,MAAME,MAAMD;QAEZF,OAAOG,IAAIY,WAAW,IAAIC,GAAG,CAACZ,SAAS,CAAC;IAC1C;AACF"}

package/dist/upgrade/report.d.ts

@@ -0,0 +1,18 @@
+import type { TransformRunResult } from '../runner.js';
+export type VersionReportRow = {
+    name: string;
+    ok: boolean;
+    resolved?: string;
+    wrote: string;
+};
+export type ReportModel = {
+    floorsWritten: string[];
+    nextTarget: null | string;
+    overridesRemoved: string[];
+    runbookPath: string;
+    transforms: TransformRunResult[];
+    versions: VersionReportRow[];
+};
+/** Build the honest end-of-run report string. Pure — the caller prints it. */
+export declare function renderReport(model: ReportModel): string;
+//# sourceMappingURL=report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/upgrade/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEtD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,OAAO,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,UAAU,EAAE,IAAI,GAAG,MAAM,CAAA;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,kBAAkB,EAAE,CAAA;IAChC,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAC7B,CAAA;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA+CvD"}

package/dist/upgrade/report.js

@@ -0,0 +1,41 @@
+/** Build the honest end-of-run report string. Pure — the caller prints it. */ export function renderReport(model) {
+    const lines = [];
+    lines.push('Payload v4 upgrade — mechanical steps complete', '');
+    lines.push('Versions written -> resolved');
+    for (const v of model.versions){
+        const resolved = v.resolved ?? '(unresolved)';
+        lines.push(`  ${v.name}  ${v.wrote} -> ${resolved}  ${v.ok ? 'ok' : 'MISMATCH'}`);
+    }
+    const anyMismatch = model.versions.some((v)=>!v.ok);
+    if (anyMismatch) {
+        lines.push('  ! Resolution mismatch — tree is NOT confirmed v4. Investigate before continuing.');
+    }
+    lines.push('');
+    if (model.overridesRemoved.length > 0) {
+        lines.push(`Overrides removed: ${model.overridesRemoved.join(', ')}`, '');
+    }
+    if (model.floorsWritten.length > 0) {
+        lines.push(`Floors written: ${model.floorsWritten.join(', ')}`, '');
+    }
+    lines.push('Transforms');
+    for (const r of model.transforms){
+        if (r.error) {
+            lines.push(`  [FAIL] ${r.name} — ${r.error.message}`);
+            continue;
+        }
+        lines.push(`  [ok] ${r.name} — ${r.filesChanged.length} file(s) changed`);
+        for (const note of r.notes ?? []){
+            lines.push(`      note: ${note}`);
+        }
+    }
+    lines.push('');
+    lines.push('Next.js: not upgraded by this command');
+    lines.push(`  Target Next version: ${model.nextTarget ?? '(see @payloadcms/next peer range)'}`);
+    lines.push('  The unmet @payloadcms/next peer is expected until you upgrade Next — that is the immediate next step.');
+    lines.push('');
+    lines.push('Not done by this command — see the runbook for the remaining steps:');
+    lines.push(`  ${model.runbookPath}`);
+    return lines.join('\n');
+}
+
+//# sourceMappingURL=report.js.map

package/dist/upgrade/report.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/report.ts"],"sourcesContent":["import type { TransformRunResult } from '../runner.js'\n\nexport type VersionReportRow = {\n  name: string\n  ok: boolean\n  resolved?: string\n  wrote: string\n}\n\nexport type ReportModel = {\n  floorsWritten: string[]\n  nextTarget: null | string\n  overridesRemoved: string[]\n  runbookPath: string\n  transforms: TransformRunResult[]\n  versions: VersionReportRow[]\n}\n\n/** Build the honest end-of-run report string. Pure — the caller prints it. */\nexport function renderReport(model: ReportModel): string {\n  const lines: string[] = []\n  lines.push('Payload v4 upgrade — mechanical steps complete', '')\n\n  lines.push('Versions written -> resolved')\n  for (const v of model.versions) {\n    const resolved = v.resolved ?? '(unresolved)'\n    lines.push(`  ${v.name}  ${v.wrote} -> ${resolved}  ${v.ok ? 'ok' : 'MISMATCH'}`)\n  }\n  const anyMismatch = model.versions.some((v) => !v.ok)\n  if (anyMismatch) {\n    lines.push('  ! Resolution mismatch — tree is NOT confirmed v4. Investigate before continuing.')\n  }\n  lines.push('')\n\n  if (model.overridesRemoved.length > 0) {\n    lines.push(`Overrides removed: ${model.overridesRemoved.join(', ')}`, '')\n  }\n\n  if (model.floorsWritten.length > 0) {\n    lines.push(`Floors written: ${model.floorsWritten.join(', ')}`, '')\n  }\n\n  lines.push('Transforms')\n  for (const r of model.transforms) {\n    if (r.error) {\n      lines.push(`  [FAIL] ${r.name} — ${r.error.message}`)\n      continue\n    }\n    lines.push(`  [ok] ${r.name} — ${r.filesChanged.length} file(s) changed`)\n    for (const note of r.notes ?? []) {\n      lines.push(`      note: ${note}`)\n    }\n  }\n  lines.push('')\n\n  lines.push('Next.js: not upgraded by this command')\n  lines.push(`  Target Next version: ${model.nextTarget ?? '(see @payloadcms/next peer range)'}`)\n  lines.push(\n    '  The unmet @payloadcms/next peer is expected until you upgrade Next — that is the immediate next step.',\n  )\n  lines.push('')\n\n  lines.push('Not done by this command — see the runbook for the remaining steps:')\n  lines.push(`  ${model.runbookPath}`)\n\n  return lines.join('\\n')\n}\n"],"names":["renderReport","model","lines","push","v","versions","resolved","name","wrote","ok","anyMismatch","some","overridesRemoved","length","join","floorsWritten","r","transforms","error","message","filesChanged","note","notes","nextTarget","runbookPath"],"mappings":"AAkBA,4EAA4E,GAC5E,OAAO,SAASA,aAAaC,KAAkB;IAC7C,MAAMC,QAAkB,EAAE;IAC1BA,MAAMC,IAAI,CAAC,kDAAkD;IAE7DD,MAAMC,IAAI,CAAC;IACX,KAAK,MAAMC,KAAKH,MAAMI,QAAQ,CAAE;QAC9B,MAAMC,WAAWF,EAAEE,QAAQ,IAAI;QAC/BJ,MAAMC,IAAI,CAAC,CAAC,EAAE,EAAEC,EAAEG,IAAI,CAAC,EAAE,EAAEH,EAAEI,KAAK,CAAC,IAAI,EAAEF,SAAS,EAAE,EAAEF,EAAEK,EAAE,GAAG,OAAO,YAAY;IAClF;IACA,MAAMC,cAAcT,MAAMI,QAAQ,CAACM,IAAI,CAAC,CAACP,IAAM,CAACA,EAAEK,EAAE;IACpD,IAAIC,aAAa;QACfR,MAAMC,IAAI,CAAC;IACb;IACAD,MAAMC,IAAI,CAAC;IAEX,IAAIF,MAAMW,gBAAgB,CAACC,MAAM,GAAG,GAAG;QACrCX,MAAMC,IAAI,CAAC,CAAC,mBAAmB,EAAEF,MAAMW,gBAAgB,CAACE,IAAI,CAAC,OAAO,EAAE;IACxE;IAEA,IAAIb,MAAMc,aAAa,CAACF,MAAM,GAAG,GAAG;QAClCX,MAAMC,IAAI,CAAC,CAAC,gBAAgB,EAAEF,MAAMc,aAAa,CAACD,IAAI,CAAC,OAAO,EAAE;IAClE;IAEAZ,MAAMC,IAAI,CAAC;IACX,KAAK,MAAMa,KAAKf,MAAMgB,UAAU,CAAE;QAChC,IAAID,EAAEE,KAAK,EAAE;YACXhB,MAAMC,IAAI,CAAC,CAAC,SAAS,EAAEa,EAAET,IAAI,CAAC,GAAG,EAAES,EAAEE,KAAK,CAACC,OAAO,EAAE;YACpD;QACF;QACAjB,MAAMC,IAAI,CAAC,CAAC,OAAO,EAAEa,EAAET,IAAI,CAAC,GAAG,EAAES,EAAEI,YAAY,CAACP,MAAM,CAAC,gBAAgB,CAAC;QACxE,KAAK,MAAMQ,QAAQL,EAAEM,KAAK,IAAI,EAAE,CAAE;YAChCpB,MAAMC,IAAI,CAAC,CAAC,YAAY,EAAEkB,MAAM;QAClC;IACF;IACAnB,MAAMC,IAAI,CAAC;IAEXD,MAAMC,IAAI,CAAC;IACXD,MAAMC,IAAI,CAAC,CAAC,uBAAuB,EAAEF,MAAMsB,UAAU,IAAI,qCAAqC;IAC9FrB,MAAMC,IAAI,CACR;IAEFD,MAAMC,IAAI,CAAC;IAEXD,MAAMC,IAAI,CAAC;IACXD,MAAMC,IAAI,CAAC,CAAC,EAAE,EAAEF,MAAMuB,WAAW,EAAE;IAEnC,OAAOtB,MAAMY,IAAI,CAAC;AACpB"}

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

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

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

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

package/dist/upgrade/report.spec.js

@@ -0,0 +1,87 @@
+import { describe, expect, it } from 'vitest';
+import { renderReport } from './report.js';
+describe('renderReport', ()=>{
+    it('renders versions, overrides, transforms, next line, and runbook pointer', ()=>{
+        const out = renderReport({
+            floorsWritten: [
+                'typescript',
+                '@types/node',
+                'engines.node'
+            ],
+            nextTarget: '16.9.3',
+            overridesRemoved: [
+                'pnpm.overrides.payload'
+            ],
+            runbookPath: '/x/dist/runbook/payload-v4-upgrade.md',
+            transforms: [
+                {
+                    filesChanged: [
+                        'a.ts'
+                    ],
+                    name: 'migrate-versions-default',
+                    notes: [
+                        'review X'
+                    ]
+                }
+            ],
+            versions: [
+                {
+                    name: 'payload',
+                    ok: true,
+                    resolved: '4.0.0-canary.20',
+                    wrote: '4.0.0-canary.20'
+                }
+            ]
+        });
+        expect(out).toContain('payload');
+        expect(out).toContain('4.0.0-canary.20');
+        expect(out).toContain('pnpm.overrides.payload');
+        expect(out).toContain('migrate-versions-default');
+        expect(out).toContain('review X');
+        expect(out).toContain('16.9.3');
+        expect(out).toContain('payload-v4-upgrade.md');
+        expect(out).toContain('Floors written');
+        expect(out).toContain('typescript');
+    });
+    it('flags a resolution mismatch as not confirmed v4', ()=>{
+        const out = renderReport({
+            floorsWritten: [],
+            nextTarget: null,
+            overridesRemoved: [],
+            runbookPath: '/x/runbook.md',
+            transforms: [],
+            versions: [
+                {
+                    name: 'payload',
+                    ok: false,
+                    resolved: '3.40.0',
+                    wrote: '4.0.0-canary.20'
+                }
+            ]
+        });
+        expect(out).toContain('MISMATCH');
+        expect(out).toContain('NOT confirmed v4');
+        expect(out).not.toContain('Floors written');
+    });
+    it('renders a failed transform with [FAIL] and its error message', ()=>{
+        const out = renderReport({
+            floorsWritten: [],
+            nextTarget: null,
+            overridesRemoved: [],
+            runbookPath: '/x/runbook.md',
+            transforms: [
+                {
+                    error: new Error('boom'),
+                    filesChanged: [],
+                    name: 'broken-transform'
+                }
+            ],
+            versions: []
+        });
+        expect(out).toContain('[FAIL]');
+        expect(out).toContain('broken-transform');
+        expect(out).toContain('boom');
+    });
+});
+
+//# sourceMappingURL=report.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/report.spec.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest'\n\nimport { renderReport } from './report.js'\n\ndescribe('renderReport', () => {\n  it('renders versions, overrides, transforms, next line, and runbook pointer', () => {\n    const out = renderReport({\n      floorsWritten: ['typescript', '@types/node', 'engines.node'],\n      nextTarget: '16.9.3',\n      overridesRemoved: ['pnpm.overrides.payload'],\n      runbookPath: '/x/dist/runbook/payload-v4-upgrade.md',\n      transforms: [\n        { filesChanged: ['a.ts'], name: 'migrate-versions-default', notes: ['review X'] },\n      ],\n      versions: [\n        { name: 'payload', ok: true, resolved: '4.0.0-canary.20', wrote: '4.0.0-canary.20' },\n      ],\n    })\n\n    expect(out).toContain('payload')\n    expect(out).toContain('4.0.0-canary.20')\n    expect(out).toContain('pnpm.overrides.payload')\n    expect(out).toContain('migrate-versions-default')\n    expect(out).toContain('review X')\n    expect(out).toContain('16.9.3')\n    expect(out).toContain('payload-v4-upgrade.md')\n    expect(out).toContain('Floors written')\n    expect(out).toContain('typescript')\n  })\n\n  it('flags a resolution mismatch as not confirmed v4', () => {\n    const out = renderReport({\n      floorsWritten: [],\n      nextTarget: null,\n      overridesRemoved: [],\n      runbookPath: '/x/runbook.md',\n      transforms: [],\n      versions: [{ name: 'payload', ok: false, resolved: '3.40.0', wrote: '4.0.0-canary.20' }],\n    })\n\n    expect(out).toContain('MISMATCH')\n    expect(out).toContain('NOT confirmed v4')\n    expect(out).not.toContain('Floors written')\n  })\n\n  it('renders a failed transform with [FAIL] and its error message', () => {\n    const out = renderReport({\n      floorsWritten: [],\n      nextTarget: null,\n      overridesRemoved: [],\n      runbookPath: '/x/runbook.md',\n      transforms: [{ error: new Error('boom'), filesChanged: [], name: 'broken-transform' }],\n      versions: [],\n    })\n\n    expect(out).toContain('[FAIL]')\n    expect(out).toContain('broken-transform')\n    expect(out).toContain('boom')\n  })\n})\n"],"names":["describe","expect","it","renderReport","out","floorsWritten","nextTarget","overridesRemoved","runbookPath","transforms","filesChanged","name","notes","versions","ok","resolved","wrote","toContain","not","error","Error"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,SAAQ;AAE7C,SAASC,YAAY,QAAQ,cAAa;AAE1CH,SAAS,gBAAgB;IACvBE,GAAG,2EAA2E;QAC5E,MAAME,MAAMD,aAAa;YACvBE,eAAe;gBAAC;gBAAc;gBAAe;aAAe;YAC5DC,YAAY;YACZC,kBAAkB;gBAAC;aAAyB;YAC5CC,aAAa;YACbC,YAAY;gBACV;oBAAEC,cAAc;wBAAC;qBAAO;oBAAEC,MAAM;oBAA4BC,OAAO;wBAAC;qBAAW;gBAAC;aACjF;YACDC,UAAU;gBACR;oBAAEF,MAAM;oBAAWG,IAAI;oBAAMC,UAAU;oBAAmBC,OAAO;gBAAkB;aACpF;QACH;QAEAf,OAAOG,KAAKa,SAAS,CAAC;QACtBhB,OAAOG,KAAKa,SAAS,CAAC;QACtBhB,OAAOG,KAAKa,SAAS,CAAC;QACtBhB,OAAOG,KAAKa,SAAS,CAAC;QACtBhB,OAAOG,KAAKa,SAAS,CAAC;QACtBhB,OAAOG,KAAKa,SAAS,CAAC;QACtBhB,OAAOG,KAAKa,SAAS,CAAC;QACtBhB,OAAOG,KAAKa,SAAS,CAAC;QACtBhB,OAAOG,KAAKa,SAAS,CAAC;IACxB;IAEAf,GAAG,mDAAmD;QACpD,MAAME,MAAMD,aAAa;YACvBE,eAAe,EAAE;YACjBC,YAAY;YACZC,kBAAkB,EAAE;YACpBC,aAAa;YACbC,YAAY,EAAE;YACdI,UAAU;gBAAC;oBAAEF,MAAM;oBAAWG,IAAI;oBAAOC,UAAU;oBAAUC,OAAO;gBAAkB;aAAE;QAC1F;QAEAf,OAAOG,KAAKa,SAAS,CAAC;QACtBhB,OAAOG,KAAKa,SAAS,CAAC;QACtBhB,OAAOG,KAAKc,GAAG,CAACD,SAAS,CAAC;IAC5B;IAEAf,GAAG,gEAAgE;QACjE,MAAME,MAAMD,aAAa;YACvBE,eAAe,EAAE;YACjBC,YAAY;YACZC,kBAAkB,EAAE;YACpBC,aAAa;YACbC,YAAY;gBAAC;oBAAEU,OAAO,IAAIC,MAAM;oBAASV,cAAc,EAAE;oBAAEC,MAAM;gBAAmB;aAAE;YACtFE,UAAU,EAAE;QACd;QAEAZ,OAAOG,KAAKa,SAAS,CAAC;QACtBhB,OAAOG,KAAKa,SAAS,CAAC;QACtBhB,OAAOG,KAAKa,SAAS,CAAC;IACxB;AACF"}

package/dist/upgrade/resolveVersions.d.ts

@@ -0,0 +1,13 @@
+import type { FetchRegistry, ResolvedVersions } from './types.js';
+type ResolveVersionsArgs = {
+    fetchRegistry: FetchRegistry;
+    tag: string;
+};
+/**
+ * Resolve the v4 target version set from the registry. Reads payload's engines
+ * and @payloadcms/next's peer range at their `tag` dist-tag, then picks the
+ * newest satisfying patch for @types/node and next. `nextTarget` is report-only.
+ */
+export declare function resolveVersions({ fetchRegistry, tag, }: ResolveVersionsArgs): Promise<ResolvedVersions>;
+export {};
+//# sourceMappingURL=resolveVersions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveVersions.d.ts","sourceRoot":"","sources":["../../src/upgrade/resolveVersions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAIjE,KAAK,mBAAmB,GAAG;IACzB,aAAa,EAAE,aAAa,CAAA;IAC5B,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,EACpC,aAAa,EACb,GAAG,GACJ,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsBjD"}

package/dist/upgrade/resolveVersions.js

@@ -0,0 +1,55 @@
+import semver from 'semver';
+import { TS_FLOOR } from './types.js';
+/**
+ * Resolve the v4 target version set from the registry. Reads payload's engines
+ * and @payloadcms/next's peer range at their `tag` dist-tag, then picks the
+ * newest satisfying patch for @types/node and next. `nextTarget` is report-only.
+ */ export async function resolveVersions({ fetchRegistry, tag }) {
+    const payloadDoc = await fetchRegistry('payload');
+    const payloadVersion = payloadDoc['dist-tags']?.[tag];
+    if (!payloadVersion) {
+        throw new Error(`payload has no dist-tag "${tag}" on the npm registry.`);
+    }
+    const enginesNode = payloadDoc.versions?.[payloadVersion]?.engines?.node;
+    if (!enginesNode) {
+        throw new Error(`payload@${payloadVersion} does not declare engines.node.`);
+    }
+    const typesNode = await newestWithinMajor(fetchRegistry, '@types/node', nodeMajor(enginesNode));
+    const nextTarget = await resolveNextTarget(fetchRegistry, tag);
+    return {
+        enginesNode,
+        nextTarget,
+        payloadVersion,
+        typescript: TS_FLOOR,
+        typesNode
+    };
+}
+function nodeMajor(enginesNode) {
+    const min = semver.minVersion(enginesNode);
+    if (!min) {
+        throw new Error(`Could not parse a Node major from engines.node "${enginesNode}".`);
+    }
+    return min.major;
+}
+async function newestWithinMajor(fetchRegistry, packageName, major) {
+    const doc = await fetchRegistry(packageName);
+    const versions = Object.keys(doc.versions ?? {});
+    const range = `>=${major}.0.0 <${major + 1}.0.0`;
+    const best = semver.maxSatisfying(versions, range);
+    if (!best) {
+        throw new Error(`No ${packageName} version found within major ${major}.`);
+    }
+    return best;
+}
+async function resolveNextTarget(fetchRegistry, tag) {
+    const nextDoc = await fetchRegistry('@payloadcms/next');
+    const version = nextDoc['dist-tags']?.[tag];
+    const range = version ? nextDoc.versions?.[version]?.peerDependencies?.next : undefined;
+    if (!range) {
+        return null;
+    }
+    const versions = Object.keys((await fetchRegistry('next')).versions ?? {});
+    return semver.maxSatisfying(versions, range);
+}
+
+//# sourceMappingURL=resolveVersions.js.map

package/dist/upgrade/resolveVersions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/resolveVersions.ts"],"sourcesContent":["import semver from 'semver'\n\nimport type { FetchRegistry, ResolvedVersions } from './types.js'\n\nimport { TS_FLOOR } from './types.js'\n\ntype ResolveVersionsArgs = {\n  fetchRegistry: FetchRegistry\n  tag: string\n}\n\n/**\n * Resolve the v4 target version set from the registry. Reads payload's engines\n * and @payloadcms/next's peer range at their `tag` dist-tag, then picks the\n * newest satisfying patch for @types/node and next. `nextTarget` is report-only.\n */\nexport async function resolveVersions({\n  fetchRegistry,\n  tag,\n}: ResolveVersionsArgs): Promise<ResolvedVersions> {\n  const payloadDoc = await fetchRegistry('payload')\n  const payloadVersion = payloadDoc['dist-tags']?.[tag]\n  if (!payloadVersion) {\n    throw new Error(`payload has no dist-tag \"${tag}\" on the npm registry.`)\n  }\n\n  const enginesNode = payloadDoc.versions?.[payloadVersion]?.engines?.node\n  if (!enginesNode) {\n    throw new Error(`payload@${payloadVersion} does not declare engines.node.`)\n  }\n\n  const typesNode = await newestWithinMajor(fetchRegistry, '@types/node', nodeMajor(enginesNode))\n  const nextTarget = await resolveNextTarget(fetchRegistry, tag)\n\n  return {\n    enginesNode,\n    nextTarget,\n    payloadVersion,\n    typescript: TS_FLOOR,\n    typesNode,\n  }\n}\n\nfunction nodeMajor(enginesNode: string): number {\n  const min = semver.minVersion(enginesNode)\n  if (!min) {\n    throw new Error(`Could not parse a Node major from engines.node \"${enginesNode}\".`)\n  }\n  return min.major\n}\n\nasync function newestWithinMajor(\n  fetchRegistry: FetchRegistry,\n  packageName: string,\n  major: number,\n): Promise<string> {\n  const doc = await fetchRegistry(packageName)\n  const versions = Object.keys(doc.versions ?? {})\n  const range = `>=${major}.0.0 <${major + 1}.0.0`\n  const best = semver.maxSatisfying(versions, range)\n  if (!best) {\n    throw new Error(`No ${packageName} version found within major ${major}.`)\n  }\n  return best\n}\n\nasync function resolveNextTarget(\n  fetchRegistry: FetchRegistry,\n  tag: string,\n): Promise<null | string> {\n  const nextDoc = await fetchRegistry('@payloadcms/next')\n  const version = nextDoc['dist-tags']?.[tag]\n  const range = version ? nextDoc.versions?.[version]?.peerDependencies?.next : undefined\n  if (!range) {\n    return null\n  }\n  const versions = Object.keys((await fetchRegistry('next')).versions ?? {})\n  return semver.maxSatisfying(versions, range)\n}\n"],"names":["semver","TS_FLOOR","resolveVersions","fetchRegistry","tag","payloadDoc","payloadVersion","Error","enginesNode","versions","engines","node","typesNode","newestWithinMajor","nodeMajor","nextTarget","resolveNextTarget","typescript","min","minVersion","major","packageName","doc","Object","keys","range","best","maxSatisfying","nextDoc","version","peerDependencies","next","undefined"],"mappings":"AAAA,OAAOA,YAAY,SAAQ;AAI3B,SAASC,QAAQ,QAAQ,aAAY;AAOrC;;;;CAIC,GACD,OAAO,eAAeC,gBAAgB,EACpCC,aAAa,EACbC,GAAG,EACiB;IACpB,MAAMC,aAAa,MAAMF,cAAc;IACvC,MAAMG,iBAAiBD,UAAU,CAAC,YAAY,EAAE,CAACD,IAAI;IACrD,IAAI,CAACE,gBAAgB;QACnB,MAAM,IAAIC,MAAM,CAAC,yBAAyB,EAAEH,IAAI,sBAAsB,CAAC;IACzE;IAEA,MAAMI,cAAcH,WAAWI,QAAQ,EAAE,CAACH,eAAe,EAAEI,SAASC;IACpE,IAAI,CAACH,aAAa;QAChB,MAAM,IAAID,MAAM,CAAC,QAAQ,EAAED,eAAe,+BAA+B,CAAC;IAC5E;IAEA,MAAMM,YAAY,MAAMC,kBAAkBV,eAAe,eAAeW,UAAUN;IAClF,MAAMO,aAAa,MAAMC,kBAAkBb,eAAeC;IAE1D,OAAO;QACLI;QACAO;QACAT;QACAW,YAAYhB;QACZW;IACF;AACF;AAEA,SAASE,UAAUN,WAAmB;IACpC,MAAMU,MAAMlB,OAAOmB,UAAU,CAACX;IAC9B,IAAI,CAACU,KAAK;QACR,MAAM,IAAIX,MAAM,CAAC,gDAAgD,EAAEC,YAAY,EAAE,CAAC;IACpF;IACA,OAAOU,IAAIE,KAAK;AAClB;AAEA,eAAeP,kBACbV,aAA4B,EAC5BkB,WAAmB,EACnBD,KAAa;IAEb,MAAME,MAAM,MAAMnB,cAAckB;IAChC,MAAMZ,WAAWc,OAAOC,IAAI,CAACF,IAAIb,QAAQ,IAAI,CAAC;IAC9C,MAAMgB,QAAQ,CAAC,EAAE,EAAEL,MAAM,MAAM,EAAEA,QAAQ,EAAE,IAAI,CAAC;IAChD,MAAMM,OAAO1B,OAAO2B,aAAa,CAAClB,UAAUgB;IAC5C,IAAI,CAACC,MAAM;QACT,MAAM,IAAInB,MAAM,CAAC,GAAG,EAAEc,YAAY,4BAA4B,EAAED,MAAM,CAAC,CAAC;IAC1E;IACA,OAAOM;AACT;AAEA,eAAeV,kBACbb,aAA4B,EAC5BC,GAAW;IAEX,MAAMwB,UAAU,MAAMzB,cAAc;IACpC,MAAM0B,UAAUD,OAAO,CAAC,YAAY,EAAE,CAACxB,IAAI;IAC3C,MAAMqB,QAAQI,UAAUD,QAAQnB,QAAQ,EAAE,CAACoB,QAAQ,EAAEC,kBAAkBC,OAAOC;IAC9E,IAAI,CAACP,OAAO;QACV,OAAO;IACT;IACA,MAAMhB,WAAWc,OAAOC,IAAI,CAAC,AAAC,CAAA,MAAMrB,cAAc,OAAM,EAAGM,QAAQ,IAAI,CAAC;IACxE,OAAOT,OAAO2B,aAAa,CAAClB,UAAUgB;AACxC"}

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

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

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

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

package/dist/upgrade/resolveVersions.spec.js

@@ -0,0 +1,82 @@
+import { describe, expect, it } from 'vitest';
+import { resolveVersions } from './resolveVersions.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': {
+        'dist-tags': {
+            latest: '24.12.3'
+        },
+        versions: {
+            '22.9.0': {},
+            '24.10.0': {},
+            '24.12.3': {},
+            '25.0.0': {}
+        }
+    },
+    next: {
+        'dist-tags': {
+            latest: '16.9.3'
+        },
+        versions: {
+            '15.5.0': {},
+            '16.2.6': {},
+            '16.9.3': {},
+            '17.0.0': {}
+        }
+    },
+    payload: {
+        'dist-tags': {
+            canary: '4.0.0-canary.20'
+        },
+        versions: {
+            '4.0.0-canary.20': {
+                engines: {
+                    node: '>=24.15.0'
+                }
+            }
+        }
+    }
+};
+const fetchRegistry = (name)=>{
+    const found = packuments[name];
+    if (!found) {
+        throw new Error(`unexpected fetch: ${name}`);
+    }
+    return Promise.resolve(found);
+};
+describe('resolveVersions', ()=>{
+    it('computes the written targets and the report-only Next target', async ()=>{
+        const resolved = await resolveVersions({
+            fetchRegistry,
+            tag: 'canary'
+        });
+        expect(resolved).toEqual({
+            enginesNode: '>=24.15.0',
+            nextTarget: '16.9.3',
+            payloadVersion: '4.0.0-canary.20',
+            typesNode: '24.12.3',
+            typescript: '6.0.3'
+        });
+    });
+    it('throws when the dist-tag is missing', async ()=>{
+        await expect(resolveVersions({
+            fetchRegistry: ()=>Promise.resolve({
+                    'dist-tags': {}
+                }),
+            tag: 'canary'
+        })).rejects.toThrow(/dist-tag "canary"/);
+    });
+});
+
+//# sourceMappingURL=resolveVersions.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/resolveVersions.spec.ts"],"sourcesContent":["import { describe, expect, it } from 'vitest'\n\nimport type { FetchRegistry, RegistryPackument } from './types.js'\n\nimport { resolveVersions } from './resolveVersions.js'\n\nconst packuments: Record<string, RegistryPackument> = {\n  '@payloadcms/next': {\n    'dist-tags': { canary: '4.0.0-canary.20' },\n    versions: {\n      '4.0.0-canary.20': { peerDependencies: { next: '>=16.2.6 <17.0.0' } },\n    },\n  },\n  '@types/node': {\n    'dist-tags': { latest: '24.12.3' },\n    versions: {\n      '22.9.0': {},\n      '24.10.0': {},\n      '24.12.3': {},\n      '25.0.0': {},\n    },\n  },\n  next: {\n    'dist-tags': { latest: '16.9.3' },\n    versions: {\n      '15.5.0': {},\n      '16.2.6': {},\n      '16.9.3': {},\n      '17.0.0': {},\n    },\n  },\n  payload: {\n    'dist-tags': { canary: '4.0.0-canary.20' },\n    versions: {\n      '4.0.0-canary.20': { engines: { node: '>=24.15.0' } },\n    },\n  },\n}\n\nconst fetchRegistry: FetchRegistry = (name) => {\n  const found = packuments[name]\n  if (!found) {\n    throw new Error(`unexpected fetch: ${name}`)\n  }\n  return Promise.resolve(found)\n}\n\ndescribe('resolveVersions', () => {\n  it('computes the written targets and the report-only Next target', async () => {\n    const resolved = await resolveVersions({ fetchRegistry, tag: 'canary' })\n\n    expect(resolved).toEqual({\n      enginesNode: '>=24.15.0',\n      nextTarget: '16.9.3', // newest within >=16.2.6 <17, excludes 17.0.0\n      payloadVersion: '4.0.0-canary.20',\n      typesNode: '24.12.3', // newest within major 24, excludes 25.0.0\n      typescript: '6.0.3',\n    })\n  })\n\n  it('throws when the dist-tag is missing', async () => {\n    await expect(\n      resolveVersions({\n        fetchRegistry: () => Promise.resolve({ 'dist-tags': {} }),\n        tag: 'canary',\n      }),\n    ).rejects.toThrow(/dist-tag \"canary\"/)\n  })\n})\n"],"names":["describe","expect","it","resolveVersions","packuments","canary","versions","peerDependencies","next","latest","payload","engines","node","fetchRegistry","name","found","Error","Promise","resolve","resolved","tag","toEqual","enginesNode","nextTarget","payloadVersion","typesNode","typescript","rejects","toThrow"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,SAAQ;AAI7C,SAASC,eAAe,QAAQ,uBAAsB;AAEtD,MAAMC,aAAgD;IACpD,oBAAoB;QAClB,aAAa;YAAEC,QAAQ;QAAkB;QACzCC,UAAU;YACR,mBAAmB;gBAAEC,kBAAkB;oBAAEC,MAAM;gBAAmB;YAAE;QACtE;IACF;IACA,eAAe;QACb,aAAa;YAAEC,QAAQ;QAAU;QACjCH,UAAU;YACR,UAAU,CAAC;YACX,WAAW,CAAC;YACZ,WAAW,CAAC;YACZ,UAAU,CAAC;QACb;IACF;IACAE,MAAM;QACJ,aAAa;YAAEC,QAAQ;QAAS;QAChCH,UAAU;YACR,UAAU,CAAC;YACX,UAAU,CAAC;YACX,UAAU,CAAC;YACX,UAAU,CAAC;QACb;IACF;IACAI,SAAS;QACP,aAAa;YAAEL,QAAQ;QAAkB;QACzCC,UAAU;YACR,mBAAmB;gBAAEK,SAAS;oBAAEC,MAAM;gBAAY;YAAE;QACtD;IACF;AACF;AAEA,MAAMC,gBAA+B,CAACC;IACpC,MAAMC,QAAQX,UAAU,CAACU,KAAK;IAC9B,IAAI,CAACC,OAAO;QACV,MAAM,IAAIC,MAAM,CAAC,kBAAkB,EAAEF,MAAM;IAC7C;IACA,OAAOG,QAAQC,OAAO,CAACH;AACzB;AAEAf,SAAS,mBAAmB;IAC1BE,GAAG,gEAAgE;QACjE,MAAMiB,WAAW,MAAMhB,gBAAgB;YAAEU;YAAeO,KAAK;QAAS;QAEtEnB,OAAOkB,UAAUE,OAAO,CAAC;YACvBC,aAAa;YACbC,YAAY;YACZC,gBAAgB;YAChBC,WAAW;YACXC,YAAY;QACd;IACF;IAEAxB,GAAG,uCAAuC;QACxC,MAAMD,OACJE,gBAAgB;YACdU,eAAe,IAAMI,QAAQC,OAAO,CAAC;oBAAE,aAAa,CAAC;gBAAE;YACvDE,KAAK;QACP,IACAO,OAAO,CAACC,OAAO,CAAC;IACpB;AACF"}

package/dist/upgrade/rewritePackageJson.d.ts

@@ -0,0 +1,25 @@
+import type { ResolvedVersions } from './types.js';
+type RewriteArgs = {
+    data: Record<string, unknown>;
+    resolved: ResolvedVersions;
+};
+export type RewriteSummary = {
+    floorsWritten: string[];
+    overridesRemoved: string[];
+    pinnedPayload: string[];
+};
+export declare const isPayloadPackage: (name: string) => boolean;
+/**
+ * The `@payloadcms/eslint-*` packages are versioned independently of the core
+ * payload packages, so they are tracked on `latest` rather than lockstep-pinned.
+ */
+export declare const isPayloadEslintPackage: (name: string) => boolean;
+/**
+ * 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 declare function rewritePackageJson({ data, resolved }: RewriteArgs): RewriteSummary;
+export {};
+//# sourceMappingURL=rewritePackageJson.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rewritePackageJson.d.ts","sourceRoot":"","sources":["../../src/upgrade/rewritePackageJson.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,QAAQ,EAAE,gBAAgB,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAA;CACxB,CAAA;AAID,eAAO,MAAM,gBAAgB,SAAU,MAAM,KAAG,OACO,CAAA;AAEvD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,SAAU,MAAM,KAAG,OACf,CAAA;AAEvC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,GAAG,cAAc,CAKlF"}