@payloadcms/codemod 4.0.0-canary.36 → 4.0.0-canary.37

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"}

package/dist/upgrade/types.d.ts

@@ -0,0 +1,47 @@
+/** 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";
+/**
+ * Path (relative to dist/) of the bundled migration guide. Present only when the
+ * monorepo copy was available at build time; the report points at it when it exists.
+ */
+export declare const MIGRATION_GUIDE_RELATIVE_PATH = "runbook/v4.mdx";
+//# 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;AAEpE;;;GAGG;AACH,eAAO,MAAM,6BAA6B,mBAAmB,CAAA"}

package/dist/upgrade/types.js

@@ -0,0 +1,11 @@
+/** 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';
+/**
+ * Path (relative to dist/) of the bundled migration guide. Present only when the
+ * monorepo copy was available at build time; the report points at it when it exists.
+ */ export const MIGRATION_GUIDE_RELATIVE_PATH = 'runbook/v4.mdx';
+
+//# 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\n/**\n * Path (relative to dist/) of the bundled migration guide. Present only when the\n * monorepo copy was available at build time; the report points at it when it exists.\n */\nexport const MIGRATION_GUIDE_RELATIVE_PATH = 'runbook/v4.mdx'\n"],"names":["TS_FLOOR","RUNBOOK_RELATIVE_PATH","MIGRATION_GUIDE_RELATIVE_PATH"],"mappings":"AAAA,wDAAwD,GA0CxD;;;CAGC,GACD,OAAO,MAAMA,WAAW,QAAO;AAE/B,iFAAiF,GACjF,OAAO,MAAMC,wBAAwB,gCAA+B;AAEpE;;;CAGC,GACD,OAAO,MAAMC,gCAAgC,iBAAgB"}

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-canary.36",
+  "version": "4.0.0-canary.37",
   "description": "Codemods for migrating Payload projects across versions.",
   "homepage": "https://payloadcms.com",
   "repository": {
@@ -29,20 +29,24 @@
     "README.md"
   ],
   "dependencies": {
+    "@clack/prompts": "1.2.0",
+    "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": "npm:@typescript/typescript6@6.0.2",
-    "vitest": "5.0.0"
+    "vitest": "5.0.1"
   },
   "engines": {
     "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 .",