@payloadcms/codemod 4.0.0-internal.7e57eed → 4.0.0-internal.8001944

package/dist/upgrade/report.d.ts

@@ -0,0 +1,21 @@
+import type { TransformRunResult } from '../runner.js';
+export type VersionReportRow = {
+    name: string;
+    ok: boolean;
+    resolved?: string;
+    wrote: string;
+};
+export type ReportModel = {
+    floorsWritten: string[];
+    /** Absolute path to the bundled migration guide, when it shipped with this build. */
+    migrationGuidePath?: string;
+    nextTarget: null | string;
+    overridesRemoved: string[];
+    placeholdersSkipped: 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,qFAAqF;IACrF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,UAAU,EAAE,IAAI,GAAG,MAAM,CAAA;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,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,CAyDvD"}

package/dist/upgrade/report.js

@@ -0,0 +1,47 @@
+/** 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.placeholdersSkipped.length > 0) {
+        lines.push(`Left as-is (workspace/catalog/link specs): ${model.placeholdersSkipped.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 these for the remaining steps:');
+    lines.push(`  runbook: ${model.runbookPath}`);
+    if (model.migrationGuidePath) {
+        lines.push(`  migration guide: ${model.migrationGuidePath}`);
+    }
+    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  /** Absolute path to the bundled migration guide, when it shipped with this build. */\n  migrationGuidePath?: string\n  nextTarget: null | string\n  overridesRemoved: string[]\n  placeholdersSkipped: 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.placeholdersSkipped.length > 0) {\n    lines.push(\n      `Left as-is (workspace/catalog/link specs): ${model.placeholdersSkipped.join(', ')}`,\n      '',\n    )\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 these for the remaining steps:')\n  lines.push(`  runbook: ${model.runbookPath}`)\n  if (model.migrationGuidePath) {\n    lines.push(`  migration guide: ${model.migrationGuidePath}`)\n  }\n\n  return lines.join('\\n')\n}\n"],"names":["renderReport","model","lines","push","v","versions","resolved","name","wrote","ok","anyMismatch","some","overridesRemoved","length","join","placeholdersSkipped","floorsWritten","r","transforms","error","message","filesChanged","note","notes","nextTarget","runbookPath","migrationGuidePath"],"mappings":"AAqBA,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,mBAAmB,CAACF,MAAM,GAAG,GAAG;QACxCX,MAAMC,IAAI,CACR,CAAC,2CAA2C,EAAEF,MAAMc,mBAAmB,CAACD,IAAI,CAAC,OAAO,EACpF;IAEJ;IAEA,IAAIb,MAAMe,aAAa,CAACH,MAAM,GAAG,GAAG;QAClCX,MAAMC,IAAI,CAAC,CAAC,gBAAgB,EAAEF,MAAMe,aAAa,CAACF,IAAI,CAAC,OAAO,EAAE;IAClE;IAEAZ,MAAMC,IAAI,CAAC;IACX,KAAK,MAAMc,KAAKhB,MAAMiB,UAAU,CAAE;QAChC,IAAID,EAAEE,KAAK,EAAE;YACXjB,MAAMC,IAAI,CAAC,CAAC,SAAS,EAAEc,EAAEV,IAAI,CAAC,GAAG,EAAEU,EAAEE,KAAK,CAACC,OAAO,EAAE;YACpD;QACF;QACAlB,MAAMC,IAAI,CAAC,CAAC,OAAO,EAAEc,EAAEV,IAAI,CAAC,GAAG,EAAEU,EAAEI,YAAY,CAACR,MAAM,CAAC,gBAAgB,CAAC;QACxE,KAAK,MAAMS,QAAQL,EAAEM,KAAK,IAAI,EAAE,CAAE;YAChCrB,MAAMC,IAAI,CAAC,CAAC,YAAY,EAAEmB,MAAM;QAClC;IACF;IACApB,MAAMC,IAAI,CAAC;IAEXD,MAAMC,IAAI,CAAC;IACXD,MAAMC,IAAI,CAAC,CAAC,uBAAuB,EAAEF,MAAMuB,UAAU,IAAI,qCAAqC;IAC9FtB,MAAMC,IAAI,CACR;IAEFD,MAAMC,IAAI,CAAC;IAEXD,MAAMC,IAAI,CAAC;IACXD,MAAMC,IAAI,CAAC,CAAC,WAAW,EAAEF,MAAMwB,WAAW,EAAE;IAC5C,IAAIxB,MAAMyB,kBAAkB,EAAE;QAC5BxB,MAAMC,IAAI,CAAC,CAAC,mBAAmB,EAAEF,MAAMyB,kBAAkB,EAAE;IAC7D;IAEA,OAAOxB,MAAMY,IAAI,CAAC;AACpB"}

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/rewritePackageJson.d.ts

@@ -0,0 +1,32 @@
+import type { ResolvedVersions } from './types.js';
+type RewriteArgs = {
+    data: Record<string, unknown>;
+    resolved: ResolvedVersions;
+};
+export type RewriteSummary = {
+    floorsWritten: string[];
+    overridesRemoved: string[];
+    pinnedPayload: string[];
+    placeholdersSkipped: 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;
+/**
+ * A dependency whose version is resolved by the package manager, not a semver
+ * range: `workspace:*`, `catalog:`, `link:`, `file:`, `npm:` aliases, URLs.
+ * Overwriting one with an exact version would break the link, so it is left as-is.
+ */
+export declare const isPlaceholderSpec: (spec: unknown) => 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":"AAEA,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;IACvB,mBAAmB,EAAE,MAAM,EAAE,CAAA;CAC9B,CAAA;AAOD,eAAO,MAAM,gBAAgB,SAAU,MAAM,KAAG,OACO,CAAA;AAEvD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,SAAU,MAAM,KAAG,OACf,CAAA;AAEvC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,SAAU,OAAO,KAAG,OACO,CAAA;AAEzD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,GAAG,cAAc,CAKlF"}

package/dist/upgrade/rewritePackageJson.js

@@ -0,0 +1,164 @@
+import semver from 'semver';
+const DEP_FIELDS = [
+    'dependencies',
+    'devDependencies'
+];
+/** Any protocol-prefixed specifier (`workspace:*`, `catalog:`, `link:`, `file:`, `npm:`, a URL). */ const PLACEHOLDER_SPEC = /^[a-z][a-z0-9+.-]*:/i;
+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');
+/**
+ * A dependency whose version is resolved by the package manager, not a semver
+ * range: `workspace:*`, `catalog:`, `link:`, `file:`, `npm:` aliases, URLs.
+ * Overwriting one with an exact version would break the link, so it is left as-is.
+ */ export const isPlaceholderSpec = (spec)=>typeof spec === 'string' && PLACEHOLDER_SPEC.test(spec);
+/**
+ * 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, placeholdersSkipped } = pinPayloadPackages(data, resolved.payloadVersion);
+    const overridesRemoved = removePayloadOverrides(data);
+    const floorsWritten = writeFloors(data, resolved);
+    return {
+        floorsWritten,
+        overridesRemoved,
+        pinnedPayload,
+        placeholdersSkipped
+    };
+}
+function pinPayloadPackages(data, version) {
+    const pinned = [];
+    const skipped = [];
+    for (const field of DEP_FIELDS){
+        const deps = data[field];
+        if (!isRecord(deps)) {
+            continue;
+        }
+        for (const name of Object.keys(deps)){
+            if (!isPayloadPackage(name)) {
+                continue;
+            }
+            // A workspace/catalog/link spec resolves itself; pinning it breaks the link.
+            if (isPlaceholderSpec(deps[name])) {
+                skipped.push(name);
+                continue;
+            }
+            if (isPayloadEslintPackage(name)) {
+                deps[name] = 'latest';
+                continue;
+            }
+            deps[name] = version;
+            pinned.push(name);
+        }
+    }
+    return {
+        pinnedPayload: pinned,
+        placeholdersSkipped: skipped
+    };
+}
+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 = [];
+    if (writeDepFloor({
+        name: 'typescript',
+        data,
+        floor: resolved.typescript
+    })) {
+        written.push('typescript');
+    }
+    if (writeDepFloor({
+        name: '@types/node',
+        data,
+        floor: resolved.typesNode
+    })) {
+        written.push('@types/node');
+    }
+    const engines = isRecord(data.engines) ? data.engines : {};
+    if (engines.node === undefined || isBelowFloor({
+        floor: resolved.enginesNode,
+        spec: engines.node
+    })) {
+        engines.node = resolved.enginesNode;
+        data.engines = engines;
+        written.push('engines.node');
+    }
+    return written;
+}
+/**
+ * Raise a dep to `floor` wherever it already lives, else add it to devDependencies.
+ * Placeholder specs, non-semver specs (e.g. `latest`), and ranges already at or
+ * above the floor are left as-is. Returns whether the dep was written.
+ */ function writeDepFloor({ name, data, floor }) {
+    for (const field of DEP_FIELDS){
+        const deps = data[field];
+        if (!isRecord(deps) || !(name in deps)) {
+            continue;
+        }
+        const spec = deps[name];
+        if (isPlaceholderSpec(spec) || !isBelowFloor({
+            floor,
+            spec
+        })) {
+            return false;
+        }
+        deps[name] = floor;
+        return true;
+    }
+    const devDeps = isRecord(data.devDependencies) ? data.devDependencies : {};
+    devDeps[name] = floor;
+    data.devDependencies = devDeps;
+    return true;
+}
+/** True only when `spec` is a semver range whose lowest version is below the floor's. */ function isBelowFloor({ floor, spec }) {
+    if (typeof spec !== 'string' || !semver.validRange(spec)) {
+        return false;
+    }
+    const specMin = semver.minVersion(spec);
+    const floorMin = semver.minVersion(floor);
+    if (!specMin || !floorMin) {
+        return false;
+    }
+    return semver.lt(specMin, floorMin);
+}
+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 semver from 'semver'\n\nimport 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  placeholdersSkipped: string[]\n}\n\nconst DEP_FIELDS = ['dependencies', 'devDependencies'] as const\n\n/** Any protocol-prefixed specifier (`workspace:*`, `catalog:`, `link:`, `file:`, `npm:`, a URL). */\nconst PLACEHOLDER_SPEC = /^[a-z][a-z0-9+.-]*:/i\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 * A dependency whose version is resolved by the package manager, not a semver\n * range: `workspace:*`, `catalog:`, `link:`, `file:`, `npm:` aliases, URLs.\n * Overwriting one with an exact version would break the link, so it is left as-is.\n */\nexport const isPlaceholderSpec = (spec: unknown): boolean =>\n  typeof spec === 'string' && PLACEHOLDER_SPEC.test(spec)\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, placeholdersSkipped } = pinPayloadPackages(data, resolved.payloadVersion)\n  const overridesRemoved = removePayloadOverrides(data)\n  const floorsWritten = writeFloors(data, resolved)\n  return { floorsWritten, overridesRemoved, pinnedPayload, placeholdersSkipped }\n}\n\nfunction pinPayloadPackages(\n  data: Record<string, unknown>,\n  version: string,\n): { pinnedPayload: string[]; placeholdersSkipped: string[] } {\n  const pinned: string[] = []\n  const skipped: 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 (!isPayloadPackage(name)) {\n        continue\n      }\n      // A workspace/catalog/link spec resolves itself; pinning it breaks the link.\n      if (isPlaceholderSpec(deps[name])) {\n        skipped.push(name)\n        continue\n      }\n      if (isPayloadEslintPackage(name)) {\n        deps[name] = 'latest'\n        continue\n      }\n      deps[name] = version\n      pinned.push(name)\n    }\n  }\n  return { pinnedPayload: pinned, placeholdersSkipped: skipped }\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  if (writeDepFloor({ name: 'typescript', data, floor: resolved.typescript })) {\n    written.push('typescript')\n  }\n  if (writeDepFloor({ name: '@types/node', data, floor: resolved.typesNode })) {\n    written.push('@types/node')\n  }\n\n  const engines = isRecord(data.engines) ? data.engines : {}\n  if (\n    engines.node === undefined ||\n    isBelowFloor({ floor: resolved.enginesNode, spec: engines.node })\n  ) {\n    engines.node = resolved.enginesNode\n    data.engines = engines\n    written.push('engines.node')\n  }\n\n  return written\n}\n\n/**\n * Raise a dep to `floor` wherever it already lives, else add it to devDependencies.\n * Placeholder specs, non-semver specs (e.g. `latest`), and ranges already at or\n * above the floor are left as-is. Returns whether the dep was written.\n */\nfunction writeDepFloor({\n  name,\n  data,\n  floor,\n}: {\n  data: Record<string, unknown>\n  floor: string\n  name: string\n}): boolean {\n  for (const field of DEP_FIELDS) {\n    const deps = data[field]\n    if (!isRecord(deps) || !(name in deps)) {\n      continue\n    }\n    const spec = deps[name]\n    if (isPlaceholderSpec(spec) || !isBelowFloor({ floor, spec })) {\n      return false\n    }\n    deps[name] = floor\n    return true\n  }\n  const devDeps = isRecord(data.devDependencies) ? data.devDependencies : {}\n  devDeps[name] = floor\n  data.devDependencies = devDeps\n  return true\n}\n\n/** True only when `spec` is a semver range whose lowest version is below the floor's. */\nfunction isBelowFloor({ floor, spec }: { floor: string; spec: unknown }): boolean {\n  if (typeof spec !== 'string' || !semver.validRange(spec)) {\n    return false\n  }\n  const specMin = semver.minVersion(spec)\n  const floorMin = semver.minVersion(floor)\n  if (!specMin || !floorMin) {\n    return false\n  }\n  return semver.lt(specMin, floorMin)\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n"],"names":["semver","DEP_FIELDS","PLACEHOLDER_SPEC","isPayloadPackage","name","startsWith","isPayloadEslintPackage","isPlaceholderSpec","spec","test","rewritePackageJson","data","resolved","pinnedPayload","placeholdersSkipped","pinPayloadPackages","payloadVersion","overridesRemoved","removePayloadOverrides","floorsWritten","writeFloors","version","pinned","skipped","field","deps","isRecord","Object","keys","push","removed","pnpm","overrides","pruneOverrideBlock","length","key","block","label","written","writeDepFloor","floor","typescript","typesNode","engines","node","undefined","isBelowFloor","enginesNode","devDeps","devDependencies","validRange","specMin","minVersion","floorMin","lt","value","Array","isArray"],"mappings":"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"}

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/selectAgent.d.ts

@@ -0,0 +1,45 @@
+export type AgentId = 'claude' | 'codex';
+export type Agent = {
+    /** Executable expected on PATH. */
+    command: string;
+    id: AgentId;
+    /** Human label shown in the picker. */
+    label: string;
+};
+/** Coding agents the dispatcher can hand the orchestration prompt to. */
+export declare const AGENTS: Agent[];
+/**
+ * Hand the prompt to `agent`, run the mechanical slice here, or print the
+ * prompt to stdout for manual use.
+ */
+export type DispatchChoice = {
+    agent: Agent;
+    kind: 'agent';
+} | {
+    kind: 'print';
+} | {
+    kind: 'run';
+};
+export type SelectDispatchArgs = {
+    /** Value of `--agent`, if the user pinned one. */
+    agentFlag?: string;
+    /** Agents found on PATH. */
+    installed: Agent[];
+    /** Both stdin and stdout are a TTY, so a picker can run. */
+    isInteractive: boolean;
+    /** Interactive picker; only called when a choice is genuinely needed. */
+    prompt: (agents: Agent[]) => Promise<DispatchChoice>;
+};
+/**
+ * Decide how to dispatch the upgrade, kept pure so the branching is unit-tested
+ * without a terminal. `--agent` wins and is strict (unknown or not-installed
+ * throws). A non-interactive session falls back to printing the prompt. Any TTY
+ * opens the picker, which offers running the mechanical slice or printing even
+ * when no agent is installed.
+ */
+export declare function selectDispatch({ agentFlag, installed, isInteractive, prompt, }: SelectDispatchArgs): Promise<DispatchChoice>;
+/** Filter the registry down to agents whose command resolves on PATH. */
+export declare function detectInstalledAgents(isAvailable?: (command: string) => boolean): Agent[];
+/** Cross-platform PATH probe using the OS command locator. */
+export declare function isCommandAvailable(command: string): boolean;
+//# sourceMappingURL=selectAgent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selectAgent.d.ts","sourceRoot":"","sources":["../../src/upgrade/selectAgent.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;AAExC,MAAM,MAAM,KAAK,GAAG;IAClB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,EAAE,EAAE,OAAO,CAAA;IACX,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,MAAM,EAAE,KAAK,EAGzB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAA;AAElG,MAAM,MAAM,kBAAkB,GAAG;IAC/B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4BAA4B;IAC5B,SAAS,EAAE,KAAK,EAAE,CAAA;IAClB,4DAA4D;IAC5D,aAAa,EAAE,OAAO,CAAA;IACtB,yEAAyE;IACzE,MAAM,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;CACrD,CAAA;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,EACnC,SAAS,EACT,SAAS,EACT,aAAa,EACb,MAAM,GACP,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAqB9C;AAED,yEAAyE;AACzE,wBAAgB,qBAAqB,CACnC,WAAW,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAA4B,GAC7D,KAAK,EAAE,CAET;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAI3D"}

package/dist/upgrade/selectAgent.js

@@ -0,0 +1,54 @@
+import { spawnSync } from 'node:child_process';
+/** Coding agents the dispatcher can hand the orchestration prompt to. */ export const AGENTS = [
+    {
+        id: 'claude',
+        command: 'claude',
+        label: 'Claude Code'
+    },
+    {
+        id: 'codex',
+        command: 'codex',
+        label: 'Codex'
+    }
+];
+/**
+ * Decide how to dispatch the upgrade, kept pure so the branching is unit-tested
+ * without a terminal. `--agent` wins and is strict (unknown or not-installed
+ * throws). A non-interactive session falls back to printing the prompt. Any TTY
+ * opens the picker, which offers running the mechanical slice or printing even
+ * when no agent is installed.
+ */ export async function selectDispatch({ agentFlag, installed, isInteractive, prompt }) {
+    if (agentFlag) {
+        const known = AGENTS.find((a)=>a.id === agentFlag);
+        if (!known) {
+            throw new Error(`Unknown agent "${agentFlag}". Supported: ${AGENTS.map((a)=>a.id).join(', ')}.`);
+        }
+        if (!installed.some((a)=>a.id === known.id)) {
+            throw new Error(`Agent "${agentFlag}" is not installed (command "${known.command}" not found).`);
+        }
+        return {
+            agent: known,
+            kind: 'agent'
+        };
+    }
+    if (!isInteractive) {
+        return {
+            kind: 'print'
+        };
+    }
+    return prompt(installed);
+}
+/** Filter the registry down to agents whose command resolves on PATH. */ export function detectInstalledAgents(isAvailable = isCommandAvailable) {
+    return AGENTS.filter((agent)=>isAvailable(agent.command));
+}
+/** Cross-platform PATH probe using the OS command locator. */ export function isCommandAvailable(command) {
+    const locator = process.platform === 'win32' ? 'where' : 'which';
+    const result = spawnSync(locator, [
+        command
+    ], {
+        stdio: 'ignore'
+    });
+    return result.status === 0;
+}
+
+//# sourceMappingURL=selectAgent.js.map

package/dist/upgrade/selectAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/selectAgent.ts"],"sourcesContent":["import { spawnSync } from 'node:child_process'\n\nexport type AgentId = 'claude' | 'codex'\n\nexport type Agent = {\n  /** Executable expected on PATH. */\n  command: string\n  id: AgentId\n  /** Human label shown in the picker. */\n  label: string\n}\n\n/** Coding agents the dispatcher can hand the orchestration prompt to. */\nexport const AGENTS: Agent[] = [\n  { id: 'claude', command: 'claude', label: 'Claude Code' },\n  { id: 'codex', command: 'codex', label: 'Codex' },\n]\n\n/**\n * Hand the prompt to `agent`, run the mechanical slice here, or print the\n * prompt to stdout for manual use.\n */\nexport type DispatchChoice = { agent: Agent; kind: 'agent' } | { kind: 'print' } | { kind: 'run' }\n\nexport type SelectDispatchArgs = {\n  /** Value of `--agent`, if the user pinned one. */\n  agentFlag?: string\n  /** Agents found on PATH. */\n  installed: Agent[]\n  /** Both stdin and stdout are a TTY, so a picker can run. */\n  isInteractive: boolean\n  /** Interactive picker; only called when a choice is genuinely needed. */\n  prompt: (agents: Agent[]) => Promise<DispatchChoice>\n}\n\n/**\n * Decide how to dispatch the upgrade, kept pure so the branching is unit-tested\n * without a terminal. `--agent` wins and is strict (unknown or not-installed\n * throws). A non-interactive session falls back to printing the prompt. Any TTY\n * opens the picker, which offers running the mechanical slice or printing even\n * when no agent is installed.\n */\nexport async function selectDispatch({\n  agentFlag,\n  installed,\n  isInteractive,\n  prompt,\n}: SelectDispatchArgs): Promise<DispatchChoice> {\n  if (agentFlag) {\n    const known = AGENTS.find((a) => a.id === agentFlag)\n    if (!known) {\n      throw new Error(\n        `Unknown agent \"${agentFlag}\". Supported: ${AGENTS.map((a) => a.id).join(', ')}.`,\n      )\n    }\n    if (!installed.some((a) => a.id === known.id)) {\n      throw new Error(\n        `Agent \"${agentFlag}\" is not installed (command \"${known.command}\" not found).`,\n      )\n    }\n    return { agent: known, kind: 'agent' }\n  }\n\n  if (!isInteractive) {\n    return { kind: 'print' }\n  }\n\n  return prompt(installed)\n}\n\n/** Filter the registry down to agents whose command resolves on PATH. */\nexport function detectInstalledAgents(\n  isAvailable: (command: string) => boolean = isCommandAvailable,\n): Agent[] {\n  return AGENTS.filter((agent) => isAvailable(agent.command))\n}\n\n/** Cross-platform PATH probe using the OS command locator. */\nexport function isCommandAvailable(command: string): boolean {\n  const locator = process.platform === 'win32' ? 'where' : 'which'\n  const result = spawnSync(locator, [command], { stdio: 'ignore' })\n  return result.status === 0\n}\n"],"names":["spawnSync","AGENTS","id","command","label","selectDispatch","agentFlag","installed","isInteractive","prompt","known","find","a","Error","map","join","some","agent","kind","detectInstalledAgents","isAvailable","isCommandAvailable","filter","locator","process","platform","result","stdio","status"],"mappings":"AAAA,SAASA,SAAS,QAAQ,qBAAoB;AAY9C,uEAAuE,GACvE,OAAO,MAAMC,SAAkB;IAC7B;QAAEC,IAAI;QAAUC,SAAS;QAAUC,OAAO;IAAc;IACxD;QAAEF,IAAI;QAASC,SAAS;QAASC,OAAO;IAAQ;CACjD,CAAA;AAmBD;;;;;;CAMC,GACD,OAAO,eAAeC,eAAe,EACnCC,SAAS,EACTC,SAAS,EACTC,aAAa,EACbC,MAAM,EACa;IACnB,IAAIH,WAAW;QACb,MAAMI,QAAQT,OAAOU,IAAI,CAAC,CAACC,IAAMA,EAAEV,EAAE,KAAKI;QAC1C,IAAI,CAACI,OAAO;YACV,MAAM,IAAIG,MACR,CAAC,eAAe,EAAEP,UAAU,cAAc,EAAEL,OAAOa,GAAG,CAAC,CAACF,IAAMA,EAAEV,EAAE,EAAEa,IAAI,CAAC,MAAM,CAAC,CAAC;QAErF;QACA,IAAI,CAACR,UAAUS,IAAI,CAAC,CAACJ,IAAMA,EAAEV,EAAE,KAAKQ,MAAMR,EAAE,GAAG;YAC7C,MAAM,IAAIW,MACR,CAAC,OAAO,EAAEP,UAAU,6BAA6B,EAAEI,MAAMP,OAAO,CAAC,aAAa,CAAC;QAEnF;QACA,OAAO;YAAEc,OAAOP;YAAOQ,MAAM;QAAQ;IACvC;IAEA,IAAI,CAACV,eAAe;QAClB,OAAO;YAAEU,MAAM;QAAQ;IACzB;IAEA,OAAOT,OAAOF;AAChB;AAEA,uEAAuE,GACvE,OAAO,SAASY,sBACdC,cAA4CC,kBAAkB;IAE9D,OAAOpB,OAAOqB,MAAM,CAAC,CAACL,QAAUG,YAAYH,MAAMd,OAAO;AAC3D;AAEA,4DAA4D,GAC5D,OAAO,SAASkB,mBAAmBlB,OAAe;IAChD,MAAMoB,UAAUC,QAAQC,QAAQ,KAAK,UAAU,UAAU;IACzD,MAAMC,SAAS1B,UAAUuB,SAAS;QAACpB;KAAQ,EAAE;QAAEwB,OAAO;IAAS;IAC/D,OAAOD,OAAOE,MAAM,KAAK;AAC3B"}

package/dist/upgrade/selfCommand.d.ts

@@ -0,0 +1,13 @@
+type ResolveSelfCommandArgs = {
+    argv1?: string;
+    override?: string;
+};
+/**
+ * The command a follower types to re-invoke this CLI. A published install lives
+ * under node_modules and is reached with npx; a source checkout is reached with
+ * `node <bin>` so local testing runs the local build, not a published version.
+ * `PAYLOAD_CODEMOD_COMMAND` overrides both.
+ */
+export declare function resolveSelfCommand({ argv1, override, }?: ResolveSelfCommandArgs): string;
+export {};
+//# sourceMappingURL=selfCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selfCommand.d.ts","sourceRoot":"","sources":["../../src/upgrade/selfCommand.ts"],"names":[],"mappings":"AAEA,KAAK,sBAAsB,GAAG;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,KAAuB,EACvB,QAA8C,GAC/C,GAAE,sBAA2B,GAAG,MAAM,CAQtC"}

package/dist/upgrade/selfCommand.js

@@ -0,0 +1,17 @@
+import { resolve } from 'node:path';
+/**
+ * The command a follower types to re-invoke this CLI. A published install lives
+ * under node_modules and is reached with npx; a source checkout is reached with
+ * `node <bin>` so local testing runs the local build, not a published version.
+ * `PAYLOAD_CODEMOD_COMMAND` overrides both.
+ */ export function resolveSelfCommand({ argv1 = process.argv[1], override = process.env.PAYLOAD_CODEMOD_COMMAND } = {}) {
+    if (override) {
+        return override;
+    }
+    if (argv1 && !argv1.includes('node_modules')) {
+        return `node ${resolve(argv1)}`;
+    }
+    return 'npx @payloadcms/codemod';
+}
+
+//# sourceMappingURL=selfCommand.js.map

package/dist/upgrade/selfCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upgrade/selfCommand.ts"],"sourcesContent":["import { resolve } from 'node:path'\n\ntype ResolveSelfCommandArgs = {\n  argv1?: string\n  override?: string\n}\n\n/**\n * The command a follower types to re-invoke this CLI. A published install lives\n * under node_modules and is reached with npx; a source checkout is reached with\n * `node <bin>` so local testing runs the local build, not a published version.\n * `PAYLOAD_CODEMOD_COMMAND` overrides both.\n */\nexport function resolveSelfCommand({\n  argv1 = process.argv[1],\n  override = process.env.PAYLOAD_CODEMOD_COMMAND,\n}: ResolveSelfCommandArgs = {}): string {\n  if (override) {\n    return override\n  }\n  if (argv1 && !argv1.includes('node_modules')) {\n    return `node ${resolve(argv1)}`\n  }\n  return 'npx @payloadcms/codemod'\n}\n"],"names":["resolve","resolveSelfCommand","argv1","process","argv","override","env","PAYLOAD_CODEMOD_COMMAND","includes"],"mappings":"AAAA,SAASA,OAAO,QAAQ,YAAW;AAOnC;;;;;CAKC,GACD,OAAO,SAASC,mBAAmB,EACjCC,QAAQC,QAAQC,IAAI,CAAC,EAAE,EACvBC,WAAWF,QAAQG,GAAG,CAACC,uBAAuB,EACvB,GAAG,CAAC,CAAC;IAC5B,IAAIF,UAAU;QACZ,OAAOA;IACT;IACA,IAAIH,SAAS,CAACA,MAAMM,QAAQ,CAAC,iBAAiB;QAC5C,OAAO,CAAC,KAAK,EAAER,QAAQE,QAAQ;IACjC;IACA,OAAO;AACT"}