create-payload-app 4.0.0-internal.5f0cd13 → 4.0.0-internal.688c4d0

package/dist/template/src/collections/Media.ts

@@ -1,5 +1,7 @@
 import type { CollectionConfig } from 'payload'
 
+import { createFolderField, createTagField } from 'payload'
+
 export const Media: CollectionConfig = {
   slug: 'media',
   access: {
@@ -11,6 +13,8 @@ export const Media: CollectionConfig = {
       type: 'text',
       required: true,
     },
+    createFolderField({ relationTo: 'folders' }),
+    createTagField({ relationTo: 'tags' }),
   ],
   upload: true,
 }

package/dist/template/src/collections/Tags.ts

@@ -0,0 +1,16 @@
+import type { CollectionConfig } from 'payload'
+
+export const Tags: CollectionConfig = {
+  slug: 'tags',
+  admin: {
+    useAsTitle: 'name',
+  },
+  tags: true,
+  fields: [
+    {
+      name: 'name',
+      type: 'text',
+      required: true,
+    },
+  ],
+}

package/dist/template/src/collections/Users.ts

@@ -10,4 +10,5 @@ export const Users: CollectionConfig = {
     // Email added by default
     // Add more fields as needed
   ],
+  versions: false,
 }

package/dist/template/src/payload-types.ts

@@ -64,11 +64,15 @@ export type SupportedTimezones =
 export interface Config {
   auth: {
     users: UserAuthOperations;
+    'payload-mcp-api-keys': PayloadMcpApiKeyAuthOperations;
   };
   blocks: {};
   collections: {
     users: User;
     media: Media;
+    folders: Folder;
+    tags: Tag;
+    'payload-mcp-api-keys': PayloadMcpApiKey;
     'payload-kv': PayloadKv;
     'payload-locked-documents': PayloadLockedDocument;
     'payload-preferences': PayloadPreference;
@@ -78,6 +82,9 @@ export interface Config {
   collectionsSelect: {
     users: UsersSelect<false> | UsersSelect<true>;
     media: MediaSelect<false> | MediaSelect<true>;
+    folders: FoldersSelect<false> | FoldersSelect<true>;
+    tags: TagsSelect<false> | TagsSelect<true>;
+    'payload-mcp-api-keys': PayloadMcpApiKeysSelect<false> | PayloadMcpApiKeysSelect<true>;
     'payload-kv': PayloadKvSelect<false> | PayloadKvSelect<true>;
     'payload-locked-documents': PayloadLockedDocumentsSelect<false> | PayloadLockedDocumentsSelect<true>;
     'payload-preferences': PayloadPreferencesSelect<false> | PayloadPreferencesSelect<true>;
@@ -86,14 +93,14 @@ export interface Config {
   db: {
     defaultIDType: string;
   };
-  fallbackLocale: null;
+  fallbackLocale: ('false' | 'none' | 'null') | false | null | 'en' | 'en'[];
   globals: {};
   globalsSelect: {};
-  locale: null;
+  locale: 'en';
   widgets: {
     collections: CollectionsWidget;
   };
-  user: User;
+  user: User | PayloadMcpApiKey;
   jobs: {
     tasks: unknown;
     workflows: unknown;
@@ -117,6 +124,24 @@ export interface UserAuthOperations {
     password: string;
   };
 }
+export interface PayloadMcpApiKeyAuthOperations {
+  forgotPassword: {
+    email: string;
+    password: string;
+  };
+  login: {
+    email: string;
+    password: string;
+  };
+  registerFirstUser: {
+    email: string;
+    password: string;
+  };
+  unlock: {
+    email: string;
+    password: string;
+  };
+}
 /**
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "users".
@@ -149,6 +174,8 @@ export interface User {
 export interface Media {
   id: string;
   alt: string;
+  _h_folders?: (string | null) | Folder;
+  _h_tags?: (string | Tag)[] | null;
   updatedAt: string;
   createdAt: string;
   url?: string | null;
@@ -161,6 +188,75 @@ export interface Media {
   focalX?: number | null;
   focalY?: number | null;
 }
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "folders".
+ */
+export interface Folder {
+  id: string;
+  _h_folders?: (string | null) | Folder;
+  name: string;
+  updatedAt: string;
+  createdAt: string;
+  _h_slugPath?: string | null;
+  _h_titlePath?: string | null;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "tags".
+ */
+export interface Tag {
+  id: string;
+  _h_tags?: (string | null) | Tag;
+  name: string;
+  updatedAt: string;
+  createdAt: string;
+  _h_slugPath?: string | null;
+  _h_titlePath?: string | null;
+}
+/**
+ * API keys control which collections, resources, tools, and prompts MCP clients can access
+ *
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "payload-mcp-api-keys".
+ */
+export interface PayloadMcpApiKey {
+  id: string;
+  /**
+   * The user that the API key is associated with.
+   */
+  user: string | User;
+  /**
+   * A useful label for the API key.
+   */
+  label?: string | null;
+  /**
+   * The purpose of the API key.
+   */
+  description?: string | null;
+  /**
+   * When checked, this key bypasses Payload access control on every operation it performs. Leave unchecked unless you have a specific reason.
+   */
+  overrideAccess?: boolean | null;
+  /**
+   * Access for this API key — uncheck to revoke individual tools.
+   */
+  access?:
+    | {
+        [k: string]: unknown;
+      }
+    | unknown[]
+    | string
+    | number
+    | boolean
+    | null;
+  updatedAt: string;
+  createdAt: string;
+  enableAPIKey?: boolean | null;
+  apiKey?: string | null;
+  apiKeyIndex?: string | null;
+  collection: 'payload-mcp-api-keys';
+}
 /**
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "payload-kv".
@@ -192,12 +288,29 @@ export interface PayloadLockedDocument {
     | ({
         relationTo: 'media';
         value: string | Media;
+      } | null)
+    | ({
+        relationTo: 'folders';
+        value: string | Folder;
+      } | null)
+    | ({
+        relationTo: 'tags';
+        value: string | Tag;
+      } | null)
+    | ({
+        relationTo: 'payload-mcp-api-keys';
+        value: string | PayloadMcpApiKey;
       } | null);
   globalSlug?: string | null;
-  user: {
-    relationTo: 'users';
-    value: string | User;
-  };
+  user:
+    | {
+        relationTo: 'users';
+        value: string | User;
+      }
+    | {
+        relationTo: 'payload-mcp-api-keys';
+        value: string | PayloadMcpApiKey;
+      };
   updatedAt: string;
   createdAt: string;
 }
@@ -207,10 +320,15 @@ export interface PayloadLockedDocument {
  */
 export interface PayloadPreference {
   id: string;
-  user: {
-    relationTo: 'users';
-    value: string | User;
-  };
+  user:
+    | {
+        relationTo: 'users';
+        value: string | User;
+      }
+    | {
+        relationTo: 'payload-mcp-api-keys';
+        value: string | PayloadMcpApiKey;
+      };
   key?: string | null;
   value?:
     | {
@@ -263,6 +381,8 @@ export interface UsersSelect<T extends boolean = true> {
  */
 export interface MediaSelect<T extends boolean = true> {
   alt?: T;
+  _h_folders?: T;
+  _h_tags?: T;
   updatedAt?: T;
   createdAt?: T;
   url?: T;
@@ -275,6 +395,46 @@ export interface MediaSelect<T extends boolean = true> {
   focalX?: T;
   focalY?: T;
 }
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "folders_select".
+ */
+export interface FoldersSelect<T extends boolean = true> {
+  _h_folders?: T;
+  name?: T;
+  updatedAt?: T;
+  createdAt?: T;
+  _h_slugPath?: T;
+  _h_titlePath?: T;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "tags_select".
+ */
+export interface TagsSelect<T extends boolean = true> {
+  _h_tags?: T;
+  name?: T;
+  updatedAt?: T;
+  createdAt?: T;
+  _h_slugPath?: T;
+  _h_titlePath?: T;
+}
+/**
+ * This interface was referenced by `Config`'s JSON-Schema
+ * via the `definition` "payload-mcp-api-keys_select".
+ */
+export interface PayloadMcpApiKeysSelect<T extends boolean = true> {
+  user?: T;
+  label?: T;
+  description?: T;
+  overrideAccess?: T;
+  access?: T;
+  updatedAt?: T;
+  createdAt?: T;
+  enableAPIKey?: T;
+  apiKey?: T;
+  apiKeyIndex?: T;
+}
 /**
  * This interface was referenced by `Config`'s JSON-Schema
  * via the `definition` "payload-kv_select".

package/dist/template/src/payload.config.ts

@@ -1,4 +1,5 @@
 import { mongooseAdapter } from '@payloadcms/db-mongodb'
+import { mcpPlugin } from '@payloadcms/plugin-mcp'
 import { lexicalEditor } from '@payloadcms/richtext-lexical'
 import path from 'path'
 import { buildConfig } from 'payload'
@@ -7,6 +8,8 @@ import sharp from 'sharp'
 
 import { Users } from './collections/Users'
 import { Media } from './collections/Media'
+import { Folders } from './collections/Folders'
+import { Tags } from './collections/Tags'
 
 const filename = fileURLToPath(import.meta.url)
 const dirname = path.dirname(filename)
@@ -18,7 +21,7 @@ export default buildConfig({
       baseDir: path.resolve(dirname),
     },
   },
-  collections: [Users, Media],
+  collections: [Users, Media, Folders, Tags],
   editor: lexicalEditor(),
   secret: process.env.PAYLOAD_SECRET || '',
   typescript: {
@@ -28,5 +31,10 @@ export default buildConfig({
     url: process.env.DATABASE_URL || '',
   }),
   sharp,
-  plugins: [],
+  localization: {
+    locales: ['en'],
+    fallback: true,
+    defaultLocale: 'en',
+  },
+  plugins: [mcpPlugin({})],
 })

package/dist/types.d.ts

@@ -18,6 +18,7 @@ export interface Args extends arg.Spec {
     '--no-agent': BooleanConstructor;
     '--no-deps': BooleanConstructor;
     '--no-git': BooleanConstructor;
+    '--payload-version': StringConstructor;
     '--secret': StringConstructor;
     '--template': StringConstructor;
     '--use-bun': BooleanConstructor;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type arg from 'arg'\n\nimport type { ALL_DATABASE_ADAPTERS, ALL_STORAGE_ADAPTERS } from './lib/ast/types.js'\n\nexport interface Args extends arg.Spec {\n  '--agent': StringConstructor\n  '--beta': BooleanConstructor\n  '--branch': StringConstructor\n  '--db': StringConstructor\n  '--db-accept-recommended': BooleanConstructor\n  '--db-connection-string': StringConstructor\n  '--debug': BooleanConstructor\n  '--dry-run': BooleanConstructor\n\n  '--example': StringConstructor\n  '--help': BooleanConstructor\n  '--init-next': BooleanConstructor\n  '--local-example': StringConstructor\n  '--local-template': StringConstructor\n  '--name': StringConstructor\n  '--no-agent': BooleanConstructor\n  '--no-deps': BooleanConstructor\n  '--no-git': BooleanConstructor\n  '--secret': StringConstructor\n  '--template': StringConstructor\n  '--use-bun': BooleanConstructor\n  '--use-npm': BooleanConstructor\n  '--use-pnpm': BooleanConstructor\n  '--use-yarn': BooleanConstructor\n\n  // Aliases\n\n  '-a': string\n  '-e': string\n  '-h': string\n  '-n': string\n  '-t': string\n}\n\nexport type CliArgs = arg.Result<Args>\n\nexport type ProjectTemplate = GitTemplate | PluginTemplate\n\nexport type ProjectExample = {\n  name: string\n  url: string\n}\n\n/**\n * Template that is cloned verbatim from a git repo\n * Performs .env manipulation based upon input\n */\nexport interface GitTemplate extends Template {\n  type: 'starter'\n  url: string\n}\n\n/**\n * Type specifically for the plugin template\n * No .env manipulation is done\n */\nexport interface PluginTemplate extends Template {\n  type: 'plugin'\n  url: string\n}\n\ninterface Template {\n  dbType?: DbType\n  description?: string\n  name: string\n  type: ProjectTemplate['type']\n}\n\nexport type PackageManager = 'bun' | 'npm' | 'pnpm' | 'yarn'\n\nexport type DbType = (typeof ALL_DATABASE_ADAPTERS)[number]\n\nexport type DbDetails = {\n  dbUri?: string\n  type: DbType\n}\n\nexport type NextAppDetails = {\n  hasTopLevelLayout: boolean\n  isPayloadInstalled?: boolean\n  isSrcDir: boolean\n  isSupportedNextVersion: boolean\n  nextAppDir?: string\n  nextConfigPath?: string\n  nextConfigType?: NextConfigType\n  nextVersion: null | string\n}\n\nexport type NextConfigType = 'cjs' | 'esm' | 'ts'\n\nexport type StorageAdapterType = (typeof ALL_STORAGE_ADAPTERS)[number]\n\nexport type AgentType = 'claude' | 'codex' | 'cursor'\n"],"names":[],"mappings":"AAiGA,WAAqD"}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type arg from 'arg'\n\nimport type { ALL_DATABASE_ADAPTERS, ALL_STORAGE_ADAPTERS } from './lib/ast/types.js'\n\nexport interface Args extends arg.Spec {\n  '--agent': StringConstructor\n  '--beta': BooleanConstructor\n  '--branch': StringConstructor\n  '--db': StringConstructor\n  '--db-accept-recommended': BooleanConstructor\n  '--db-connection-string': StringConstructor\n  '--debug': BooleanConstructor\n  '--dry-run': BooleanConstructor\n\n  '--example': StringConstructor\n  '--help': BooleanConstructor\n  '--init-next': BooleanConstructor\n  '--local-example': StringConstructor\n  '--local-template': StringConstructor\n  '--name': StringConstructor\n  '--no-agent': BooleanConstructor\n  '--no-deps': BooleanConstructor\n  '--no-git': BooleanConstructor\n  '--payload-version': StringConstructor\n  '--secret': StringConstructor\n  '--template': StringConstructor\n  '--use-bun': BooleanConstructor\n  '--use-npm': BooleanConstructor\n  '--use-pnpm': BooleanConstructor\n  '--use-yarn': BooleanConstructor\n\n  // Aliases\n\n  '-a': string\n  '-e': string\n  '-h': string\n  '-n': string\n  '-t': string\n}\n\nexport type CliArgs = arg.Result<Args>\n\nexport type ProjectTemplate = GitTemplate | PluginTemplate\n\nexport type ProjectExample = {\n  name: string\n  url: string\n}\n\n/**\n * Template that is cloned verbatim from a git repo\n * Performs .env manipulation based upon input\n */\nexport interface GitTemplate extends Template {\n  type: 'starter'\n  url: string\n}\n\n/**\n * Type specifically for the plugin template\n * No .env manipulation is done\n */\nexport interface PluginTemplate extends Template {\n  type: 'plugin'\n  url: string\n}\n\ninterface Template {\n  dbType?: DbType\n  description?: string\n  name: string\n  type: ProjectTemplate['type']\n}\n\nexport type PackageManager = 'bun' | 'npm' | 'pnpm' | 'yarn'\n\nexport type DbType = (typeof ALL_DATABASE_ADAPTERS)[number]\n\nexport type DbDetails = {\n  dbUri?: string\n  type: DbType\n}\n\nexport type NextAppDetails = {\n  hasTopLevelLayout: boolean\n  isPayloadInstalled?: boolean\n  isSrcDir: boolean\n  isSupportedNextVersion: boolean\n  nextAppDir?: string\n  nextConfigPath?: string\n  nextConfigType?: NextConfigType\n  nextVersion: null | string\n}\n\nexport type NextConfigType = 'cjs' | 'esm' | 'ts'\n\nexport type StorageAdapterType = (typeof ALL_STORAGE_ADAPTERS)[number]\n\nexport type AgentType = 'claude' | 'codex' | 'cursor'\n"],"names":[],"mappings":"AAkGA,WAAqD"}

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

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/utils/messages.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAA;AAMlE,eAAO,MAAM,cAAc,QAE1B,CAAA;AAID,wBAAgB,WAAW,IAAI,IAAI,CAmClC;AAQD,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,GAAG,MAAM,CAiBzF;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAO3C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAgBpF;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/utils/messages.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAA;AAMlE,eAAO,MAAM,cAAc,QAE1B,CAAA;AAID,wBAAgB,WAAW,IAAI,IAAI,CAoClC;AAQD,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,GAAG,MAAM,CAiBzF;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAO3C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAgBpF;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/utils/messages.js

@@ -40,6 +40,7 @@ export function helpMessage() {
       --use-pnpm                    Use pnpm to install dependencies
       --use-bun                     Use bun to install dependencies (experimental)
       --no-deps                     Do not install any dependencies
+      --payload-version {underline value}       Install a specific Payload version or npm dist-tag (default: canary)
       -h                            Show help
 `);
 }

package/dist/utils/messages.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/messages.ts"],"sourcesContent":["/* eslint-disable no-console */\nimport chalk from 'chalk'\nimport path from 'path'\nimport terminalLink from 'terminal-link'\n\nimport type { PackageManager, ProjectTemplate } from '../types.js'\n\nimport { getValidTemplates } from '../lib/templates.js'\n\nconst header = (message: string): string => chalk.bold(message)\n\nexport const welcomeMessage = chalk`\n  {green Welcome to Payload. Let's create a project! }\n`\n\nconst spacer = ' '.repeat(8)\n\nexport function helpMessage(): void {\n  const validTemplates = getValidTemplates()\n  console.log(chalk`\n  {bold USAGE}\n\n      {dim Inside of an existing Next.js project}\n\n      {dim $} {bold npx create-payload-app}\n\n      {dim Create a new project from scratch}\n\n      {dim $} {bold npx create-payload-app}\n      {dim $} {bold npx create-payload-app} my-project\n      {dim $} {bold npx create-payload-app} -n my-project -t template-name\n\n  {bold OPTIONS}\n\n      -n     {underline my-payload-app}         Set project name\n      -t     {underline template_name}          Choose specific template\n      -e     {underline example_name}           Choose specific example\n\n        {dim Available templates: ${formatTemplates(validTemplates)}}\n\n      -a     {underline agent_name}             Set coding agent (claude, codex, cursor)\n\n        {dim Installs the Payload skill for the selected agent}\n\n      --no-agent                    Skip agent skill installation\n      --use-npm                     Use npm to install dependencies\n      --use-yarn                    Use yarn to install dependencies\n      --use-pnpm                    Use pnpm to install dependencies\n      --use-bun                     Use bun to install dependencies (experimental)\n      --no-deps                     Do not install any dependencies\n      -h                            Show help\n`)\n}\n\nfunction formatTemplates(templates: ProjectTemplate[]) {\n  return `\\n\\n${spacer}${templates\n    .map((t) => `${t.name}${' '.repeat(28 - t.name.length)}${t.description}`)\n    .join(`\\n${spacer}`)}`\n}\n\nexport function successMessage(projectDir: string, packageManager: PackageManager): string {\n  const relativePath = path.relative(process.cwd(), projectDir)\n  return `\n${header('Launch Application:')}\n\n  - cd ./${relativePath}\n  - ${packageManager === 'npm' ? 'npm run' : packageManager} dev or follow directions in README.md\n\n${header('Documentation:')}\n\n  - ${createTerminalLink(\n    'Getting Started',\n    'https://payloadcms.com/docs/getting-started/what-is-payload',\n  )}\n  - ${createTerminalLink('Configuration', 'https://payloadcms.com/docs/configuration/overview')}\n\n`\n}\n\nexport function successfulNextInit(): string {\n  return `- ${createTerminalLink(\n    'Getting Started',\n    'https://payloadcms.com/docs/getting-started/what-is-payload',\n  )}\n- ${createTerminalLink('Configuration', 'https://payloadcms.com/docs/configuration/overview')}\n`\n}\n\nexport function moveMessage(args: { nextAppDir: string; projectDir: string }): string {\n  const relativeAppDir = path.relative(process.cwd(), args.nextAppDir)\n  return `\n${header('Next Steps:')}\n\nPayload does not support a top-level layout.tsx file in the app directory.\n\n${chalk.bold('To continue:')}\n\n- Create a new directory in ./${relativeAppDir} such as ./${relativeAppDir}/${chalk.bold('(app)')}\n- Move all files from ./${relativeAppDir} into that directory\n\nIt is recommended to do this from your IDE if your app has existing file references.\n\nOnce moved, rerun the create-payload-app command again.\n`\n}\n\nexport function feedbackOutro(): string {\n  return `${chalk.bgCyan(chalk.black(' Have feedback? '))} Visit us on ${createTerminalLink('GitHub', 'https://github.com/payloadcms/payload')}.`\n}\n\n// Create terminalLink with fallback for unsupported terminals\nfunction createTerminalLink(text: string, url: string) {\n  return terminalLink(text, url, {\n    fallback: (text, url) => `${text}: ${url}`,\n  })\n}\n"],"names":["chalk","path","terminalLink","getValidTemplates","header","message","bold","welcomeMessage","spacer","repeat","helpMessage","validTemplates","console","log","formatTemplates","templates","map","t","name","length","description","join","successMessage","projectDir","packageManager","relativePath","relative","process","cwd","createTerminalLink","successfulNextInit","moveMessage","args","relativeAppDir","nextAppDir","feedbackOutro","bgCyan","black","text","url","fallback"],"mappings":"AAAA,6BAA6B,GAC7B,OAAOA,WAAW,QAAO;AACzB,OAAOC,UAAU,OAAM;AACvB,OAAOC,kBAAkB,gBAAe;AAIxC,SAASC,iBAAiB,QAAQ,sBAAqB;AAEvD,MAAMC,SAAS,CAACC,UAA4BL,MAAMM,IAAI,CAACD;AAEvD,OAAO,MAAME,iBAAiBP,KAAK,CAAC;;AAEpC,CAAC,CAAA;AAED,MAAMQ,SAAS,IAAIC,MAAM,CAAC;AAE1B,OAAO,SAASC;IACd,MAAMC,iBAAiBR;IACvBS,QAAQC,GAAG,CAACb,KAAK,CAAC;;;;;;;;;;;;;;;;;;;kCAmBc,EAAEc,gBAAgBH,gBAAgB;;;;;;;;;;;;;AAapE,CAAC;AACD;AAEA,SAASG,gBAAgBC,SAA4B;IACnD,OAAO,CAAC,IAAI,EAAEP,SAASO,UACpBC,GAAG,CAAC,CAACC,IAAM,GAAGA,EAAEC,IAAI,GAAG,IAAIT,MAAM,CAAC,KAAKQ,EAAEC,IAAI,CAACC,MAAM,IAAIF,EAAEG,WAAW,EAAE,EACvEC,IAAI,CAAC,CAAC,EAAE,EAAEb,QAAQ,GAAG;AAC1B;AAEA,OAAO,SAASc,eAAeC,UAAkB,EAAEC,cAA8B;IAC/E,MAAMC,eAAexB,KAAKyB,QAAQ,CAACC,QAAQC,GAAG,IAAIL;IAClD,OAAO,CAAC;AACV,EAAEnB,OAAO,uBAAuB;;SAEvB,EAAEqB,aAAa;IACpB,EAAED,mBAAmB,QAAQ,YAAYA,eAAe;;AAE5D,EAAEpB,OAAO,kBAAkB;;IAEvB,EAAEyB,mBACF,mBACA,+DACA;IACA,EAAEA,mBAAmB,iBAAiB,sDAAsD;;AAEhG,CAAC;AACD;AAEA,OAAO,SAASC;IACd,OAAO,CAAC,EAAE,EAAED,mBACV,mBACA,+DACA;EACF,EAAEA,mBAAmB,iBAAiB,sDAAsD;AAC9F,CAAC;AACD;AAEA,OAAO,SAASE,YAAYC,IAAgD;IAC1E,MAAMC,iBAAiBhC,KAAKyB,QAAQ,CAACC,QAAQC,GAAG,IAAII,KAAKE,UAAU;IACnE,OAAO,CAAC;AACV,EAAE9B,OAAO,eAAe;;;;AAIxB,EAAEJ,MAAMM,IAAI,CAAC,gBAAgB;;8BAEC,EAAE2B,eAAe,WAAW,EAAEA,eAAe,CAAC,EAAEjC,MAAMM,IAAI,CAAC,SAAS;wBAC1E,EAAE2B,eAAe;;;;;AAKzC,CAAC;AACD;AAEA,OAAO,SAASE;IACd,OAAO,GAAGnC,MAAMoC,MAAM,CAACpC,MAAMqC,KAAK,CAAC,qBAAqB,aAAa,EAAER,mBAAmB,UAAU,yCAAyC,CAAC,CAAC;AACjJ;AAEA,8DAA8D;AAC9D,SAASA,mBAAmBS,IAAY,EAAEC,GAAW;IACnD,OAAOrC,aAAaoC,MAAMC,KAAK;QAC7BC,UAAU,CAACF,MAAMC,MAAQ,GAAGD,KAAK,EAAE,EAAEC,KAAK;IAC5C;AACF"}
+{"version":3,"sources":["../../src/utils/messages.ts"],"sourcesContent":["/* eslint-disable no-console */\nimport chalk from 'chalk'\nimport path from 'path'\nimport terminalLink from 'terminal-link'\n\nimport type { PackageManager, ProjectTemplate } from '../types.js'\n\nimport { getValidTemplates } from '../lib/templates.js'\n\nconst header = (message: string): string => chalk.bold(message)\n\nexport const welcomeMessage = chalk`\n  {green Welcome to Payload. Let's create a project! }\n`\n\nconst spacer = ' '.repeat(8)\n\nexport function helpMessage(): void {\n  const validTemplates = getValidTemplates()\n  console.log(chalk`\n  {bold USAGE}\n\n      {dim Inside of an existing Next.js project}\n\n      {dim $} {bold npx create-payload-app}\n\n      {dim Create a new project from scratch}\n\n      {dim $} {bold npx create-payload-app}\n      {dim $} {bold npx create-payload-app} my-project\n      {dim $} {bold npx create-payload-app} -n my-project -t template-name\n\n  {bold OPTIONS}\n\n      -n     {underline my-payload-app}         Set project name\n      -t     {underline template_name}          Choose specific template\n      -e     {underline example_name}           Choose specific example\n\n        {dim Available templates: ${formatTemplates(validTemplates)}}\n\n      -a     {underline agent_name}             Set coding agent (claude, codex, cursor)\n\n        {dim Installs the Payload skill for the selected agent}\n\n      --no-agent                    Skip agent skill installation\n      --use-npm                     Use npm to install dependencies\n      --use-yarn                    Use yarn to install dependencies\n      --use-pnpm                    Use pnpm to install dependencies\n      --use-bun                     Use bun to install dependencies (experimental)\n      --no-deps                     Do not install any dependencies\n      --payload-version {underline value}       Install a specific Payload version or npm dist-tag (default: canary)\n      -h                            Show help\n`)\n}\n\nfunction formatTemplates(templates: ProjectTemplate[]) {\n  return `\\n\\n${spacer}${templates\n    .map((t) => `${t.name}${' '.repeat(28 - t.name.length)}${t.description}`)\n    .join(`\\n${spacer}`)}`\n}\n\nexport function successMessage(projectDir: string, packageManager: PackageManager): string {\n  const relativePath = path.relative(process.cwd(), projectDir)\n  return `\n${header('Launch Application:')}\n\n  - cd ./${relativePath}\n  - ${packageManager === 'npm' ? 'npm run' : packageManager} dev or follow directions in README.md\n\n${header('Documentation:')}\n\n  - ${createTerminalLink(\n    'Getting Started',\n    'https://payloadcms.com/docs/getting-started/what-is-payload',\n  )}\n  - ${createTerminalLink('Configuration', 'https://payloadcms.com/docs/configuration/overview')}\n\n`\n}\n\nexport function successfulNextInit(): string {\n  return `- ${createTerminalLink(\n    'Getting Started',\n    'https://payloadcms.com/docs/getting-started/what-is-payload',\n  )}\n- ${createTerminalLink('Configuration', 'https://payloadcms.com/docs/configuration/overview')}\n`\n}\n\nexport function moveMessage(args: { nextAppDir: string; projectDir: string }): string {\n  const relativeAppDir = path.relative(process.cwd(), args.nextAppDir)\n  return `\n${header('Next Steps:')}\n\nPayload does not support a top-level layout.tsx file in the app directory.\n\n${chalk.bold('To continue:')}\n\n- Create a new directory in ./${relativeAppDir} such as ./${relativeAppDir}/${chalk.bold('(app)')}\n- Move all files from ./${relativeAppDir} into that directory\n\nIt is recommended to do this from your IDE if your app has existing file references.\n\nOnce moved, rerun the create-payload-app command again.\n`\n}\n\nexport function feedbackOutro(): string {\n  return `${chalk.bgCyan(chalk.black(' Have feedback? '))} Visit us on ${createTerminalLink('GitHub', 'https://github.com/payloadcms/payload')}.`\n}\n\n// Create terminalLink with fallback for unsupported terminals\nfunction createTerminalLink(text: string, url: string) {\n  return terminalLink(text, url, {\n    fallback: (text, url) => `${text}: ${url}`,\n  })\n}\n"],"names":["chalk","path","terminalLink","getValidTemplates","header","message","bold","welcomeMessage","spacer","repeat","helpMessage","validTemplates","console","log","formatTemplates","templates","map","t","name","length","description","join","successMessage","projectDir","packageManager","relativePath","relative","process","cwd","createTerminalLink","successfulNextInit","moveMessage","args","relativeAppDir","nextAppDir","feedbackOutro","bgCyan","black","text","url","fallback"],"mappings":"AAAA,6BAA6B,GAC7B,OAAOA,WAAW,QAAO;AACzB,OAAOC,UAAU,OAAM;AACvB,OAAOC,kBAAkB,gBAAe;AAIxC,SAASC,iBAAiB,QAAQ,sBAAqB;AAEvD,MAAMC,SAAS,CAACC,UAA4BL,MAAMM,IAAI,CAACD;AAEvD,OAAO,MAAME,iBAAiBP,KAAK,CAAC;;AAEpC,CAAC,CAAA;AAED,MAAMQ,SAAS,IAAIC,MAAM,CAAC;AAE1B,OAAO,SAASC;IACd,MAAMC,iBAAiBR;IACvBS,QAAQC,GAAG,CAACb,KAAK,CAAC;;;;;;;;;;;;;;;;;;;kCAmBc,EAAEc,gBAAgBH,gBAAgB;;;;;;;;;;;;;;AAcpE,CAAC;AACD;AAEA,SAASG,gBAAgBC,SAA4B;IACnD,OAAO,CAAC,IAAI,EAAEP,SAASO,UACpBC,GAAG,CAAC,CAACC,IAAM,GAAGA,EAAEC,IAAI,GAAG,IAAIT,MAAM,CAAC,KAAKQ,EAAEC,IAAI,CAACC,MAAM,IAAIF,EAAEG,WAAW,EAAE,EACvEC,IAAI,CAAC,CAAC,EAAE,EAAEb,QAAQ,GAAG;AAC1B;AAEA,OAAO,SAASc,eAAeC,UAAkB,EAAEC,cAA8B;IAC/E,MAAMC,eAAexB,KAAKyB,QAAQ,CAACC,QAAQC,GAAG,IAAIL;IAClD,OAAO,CAAC;AACV,EAAEnB,OAAO,uBAAuB;;SAEvB,EAAEqB,aAAa;IACpB,EAAED,mBAAmB,QAAQ,YAAYA,eAAe;;AAE5D,EAAEpB,OAAO,kBAAkB;;IAEvB,EAAEyB,mBACF,mBACA,+DACA;IACA,EAAEA,mBAAmB,iBAAiB,sDAAsD;;AAEhG,CAAC;AACD;AAEA,OAAO,SAASC;IACd,OAAO,CAAC,EAAE,EAAED,mBACV,mBACA,+DACA;EACF,EAAEA,mBAAmB,iBAAiB,sDAAsD;AAC9F,CAAC;AACD;AAEA,OAAO,SAASE,YAAYC,IAAgD;IAC1E,MAAMC,iBAAiBhC,KAAKyB,QAAQ,CAACC,QAAQC,GAAG,IAAII,KAAKE,UAAU;IACnE,OAAO,CAAC;AACV,EAAE9B,OAAO,eAAe;;;;AAIxB,EAAEJ,MAAMM,IAAI,CAAC,gBAAgB;;8BAEC,EAAE2B,eAAe,WAAW,EAAEA,eAAe,CAAC,EAAEjC,MAAMM,IAAI,CAAC,SAAS;wBAC1E,EAAE2B,eAAe;;;;;AAKzC,CAAC;AACD;AAEA,OAAO,SAASE;IACd,OAAO,GAAGnC,MAAMoC,MAAM,CAACpC,MAAMqC,KAAK,CAAC,qBAAqB,aAAa,EAAER,mBAAmB,UAAU,yCAAyC,CAAC,CAAC;AACjJ;AAEA,8DAA8D;AAC9D,SAASA,mBAAmBS,IAAY,EAAEC,GAAW;IACnD,OAAOrC,aAAaoC,MAAMC,KAAK;QAC7BC,UAAU,CAACF,MAAMC,MAAQ,GAAGD,KAAK,EAAE,EAAEC,KAAK;IAC5C;AACF"}

package/dist/utils/resolvePackageVersion.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Default npm dist-tag used by the create-payload-app CLI when no
+ * `--payload-version` is provided. The CLI scaffolds against canary by default.
+ */
+export declare const DEFAULT_PAYLOAD_VERSION_TAG = "canary";
+/**
+ * Resolves a package version from either an npm dist-tag (e.g. `canary`) or an
+ * explicit version number (e.g. `3.40.0`).
+ *
+ * A value matching a published dist-tag resolves to that tag's concrete version.
+ * Any other value is treated as an explicit version and verified to exist on the
+ * registry. Throws if neither a matching tag nor a published version is found.
+ */
+export declare function resolvePackageVersion({ debug, packageName, versionOrTag, }: {
+    debug?: boolean;
+    /**
+     * Package name to resolve against the npm registry.
+     *
+     * @default 'payload'
+     */
+    packageName?: string;
+    /**
+     * An npm dist-tag (e.g. `latest`, `canary`) or an explicit version (e.g. `3.40.0`).
+     *
+     * @default 'latest'
+     */
+    versionOrTag?: string;
+}): Promise<string>;
+//# sourceMappingURL=resolvePackageVersion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolvePackageVersion.d.ts","sourceRoot":"","sources":["../../src/utils/resolvePackageVersion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,2BAA2B,WAAW,CAAA;AAEnD;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,KAAa,EACb,WAAuB,EACvB,YAAuB,GACxB,EAAE;IACD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBlB"}

package/dist/utils/resolvePackageVersion.js

@@ -0,0 +1,41 @@
+/**
+ * Default npm dist-tag used by the create-payload-app CLI when no
+ * `--payload-version` is provided. The CLI scaffolds against canary by default.
+ */ export const DEFAULT_PAYLOAD_VERSION_TAG = 'canary';
+/**
+ * Resolves a package version from either an npm dist-tag (e.g. `canary`) or an
+ * explicit version number (e.g. `3.40.0`).
+ *
+ * A value matching a published dist-tag resolves to that tag's concrete version.
+ * Any other value is treated as an explicit version and verified to exist on the
+ * registry. Throws if neither a matching tag nor a published version is found.
+ */ export async function resolvePackageVersion({ debug = false, packageName = 'payload', versionOrTag = 'latest' }) {
+    const distTags = await fetchDistTags(packageName);
+    const taggedVersion = distTags[versionOrTag];
+    if (taggedVersion) {
+        if (debug) {
+            console.log(`Resolved ${packageName}@${versionOrTag} to ${taggedVersion}`);
+        }
+        return taggedVersion;
+    }
+    await verifyVersionExists({
+        packageName,
+        version: versionOrTag
+    });
+    if (debug) {
+        console.log(`Using ${packageName}@${versionOrTag}`);
+    }
+    return versionOrTag;
+}
+async function fetchDistTags(packageName) {
+    const response = await fetch(`https://registry.npmjs.org/-/package/${packageName}/dist-tags`);
+    return await response.json();
+}
+async function verifyVersionExists({ packageName, version }) {
+    const response = await fetch(`https://registry.npmjs.org/${packageName}/${version}`);
+    if (response.status !== 200) {
+        throw new Error(`No version or tag "${version}" found for package: ${packageName}`);
+    }
+}
+
+//# sourceMappingURL=resolvePackageVersion.js.map

package/dist/utils/resolvePackageVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/resolvePackageVersion.ts"],"sourcesContent":["/**\n * Default npm dist-tag used by the create-payload-app CLI when no\n * `--payload-version` is provided. The CLI scaffolds against canary by default.\n */\nexport const DEFAULT_PAYLOAD_VERSION_TAG = 'canary'\n\n/**\n * Resolves a package version from either an npm dist-tag (e.g. `canary`) or an\n * explicit version number (e.g. `3.40.0`).\n *\n * A value matching a published dist-tag resolves to that tag's concrete version.\n * Any other value is treated as an explicit version and verified to exist on the\n * registry. Throws if neither a matching tag nor a published version is found.\n */\nexport async function resolvePackageVersion({\n  debug = false,\n  packageName = 'payload',\n  versionOrTag = 'latest',\n}: {\n  debug?: boolean\n  /**\n   * Package name to resolve against the npm registry.\n   *\n   * @default 'payload'\n   */\n  packageName?: string\n  /**\n   * An npm dist-tag (e.g. `latest`, `canary`) or an explicit version (e.g. `3.40.0`).\n   *\n   * @default 'latest'\n   */\n  versionOrTag?: string\n}): Promise<string> {\n  const distTags = await fetchDistTags(packageName)\n\n  const taggedVersion = distTags[versionOrTag]\n  if (taggedVersion) {\n    if (debug) {\n      console.log(`Resolved ${packageName}@${versionOrTag} to ${taggedVersion}`)\n    }\n    return taggedVersion\n  }\n\n  await verifyVersionExists({ packageName, version: versionOrTag })\n\n  if (debug) {\n    console.log(`Using ${packageName}@${versionOrTag}`)\n  }\n  return versionOrTag\n}\n\nasync function fetchDistTags(packageName: string): Promise<Record<string, string>> {\n  const response = await fetch(`https://registry.npmjs.org/-/package/${packageName}/dist-tags`)\n  return (await response.json()) as Record<string, string>\n}\n\nasync function verifyVersionExists({\n  packageName,\n  version,\n}: {\n  packageName: string\n  version: string\n}): Promise<void> {\n  const response = await fetch(`https://registry.npmjs.org/${packageName}/${version}`)\n  if (response.status !== 200) {\n    throw new Error(`No version or tag \"${version}\" found for package: ${packageName}`)\n  }\n}\n"],"names":["DEFAULT_PAYLOAD_VERSION_TAG","resolvePackageVersion","debug","packageName","versionOrTag","distTags","fetchDistTags","taggedVersion","console","log","verifyVersionExists","version","response","fetch","json","status","Error"],"mappings":"AAAA;;;CAGC,GACD,OAAO,MAAMA,8BAA8B,SAAQ;AAEnD;;;;;;;CAOC,GACD,OAAO,eAAeC,sBAAsB,EAC1CC,QAAQ,KAAK,EACbC,cAAc,SAAS,EACvBC,eAAe,QAAQ,EAexB;IACC,MAAMC,WAAW,MAAMC,cAAcH;IAErC,MAAMI,gBAAgBF,QAAQ,CAACD,aAAa;IAC5C,IAAIG,eAAe;QACjB,IAAIL,OAAO;YACTM,QAAQC,GAAG,CAAC,CAAC,SAAS,EAAEN,YAAY,CAAC,EAAEC,aAAa,IAAI,EAAEG,eAAe;QAC3E;QACA,OAAOA;IACT;IAEA,MAAMG,oBAAoB;QAAEP;QAAaQ,SAASP;IAAa;IAE/D,IAAIF,OAAO;QACTM,QAAQC,GAAG,CAAC,CAAC,MAAM,EAAEN,YAAY,CAAC,EAAEC,cAAc;IACpD;IACA,OAAOA;AACT;AAEA,eAAeE,cAAcH,WAAmB;IAC9C,MAAMS,WAAW,MAAMC,MAAM,CAAC,qCAAqC,EAAEV,YAAY,UAAU,CAAC;IAC5F,OAAQ,MAAMS,SAASE,IAAI;AAC7B;AAEA,eAAeJ,oBAAoB,EACjCP,WAAW,EACXQ,OAAO,EAIR;IACC,MAAMC,WAAW,MAAMC,MAAM,CAAC,2BAA2B,EAAEV,YAAY,CAAC,EAAEQ,SAAS;IACnF,IAAIC,SAASG,MAAM,KAAK,KAAK;QAC3B,MAAM,IAAIC,MAAM,CAAC,mBAAmB,EAAEL,QAAQ,qBAAqB,EAAER,aAAa;IACpF;AACF"}

package/dist/utils/resolvePackageVersion.spec.js

@@ -0,0 +1,77 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { DEFAULT_PAYLOAD_VERSION_TAG, resolvePackageVersion } from './resolvePackageVersion.js';
+const mockRegistry = ({ distTags, validVersions = [] })=>vi.stubGlobal('fetch', vi.fn((url)=>{
+        if (url.endsWith('/dist-tags')) {
+            return Promise.resolve({
+                json: ()=>Promise.resolve(distTags)
+            });
+        }
+        const version = url.split('/').pop() ?? '';
+        return Promise.resolve({
+            status: validVersions.includes(version) ? 200 : 404
+        });
+    }));
+describe('resolvePackageVersion', ()=>{
+    afterEach(()=>{
+        vi.unstubAllGlobals();
+        vi.restoreAllMocks();
+    });
+    it('should resolve a dist-tag to its concrete version', async ()=>{
+        mockRegistry({
+            distTags: {
+                canary: '3.0.0-canary.abc',
+                latest: '2.9.0'
+            }
+        });
+        const version = await resolvePackageVersion({
+            packageName: 'payload',
+            versionOrTag: 'canary'
+        });
+        expect(version).toBe('3.0.0-canary.abc');
+    });
+    it('should default to the latest tag when no value is provided', async ()=>{
+        mockRegistry({
+            distTags: {
+                canary: '3.0.0-canary.abc',
+                latest: '2.9.0'
+            }
+        });
+        const version = await resolvePackageVersion({
+            packageName: 'payload'
+        });
+        expect(version).toBe('2.9.0');
+    });
+    it('should return an explicit version when it exists on the registry', async ()=>{
+        mockRegistry({
+            distTags: {
+                latest: '2.9.0'
+            },
+            validVersions: [
+                '3.1.0'
+            ]
+        });
+        const version = await resolvePackageVersion({
+            packageName: 'payload',
+            versionOrTag: '3.1.0'
+        });
+        expect(version).toBe('3.1.0');
+    });
+    it('should throw a clear error when neither a tag nor a version is found', async ()=>{
+        mockRegistry({
+            distTags: {
+                latest: '2.9.0'
+            }
+        });
+        await expect(resolvePackageVersion({
+            packageName: 'payload',
+            versionOrTag: 'nope'
+        })).rejects.toThrow('No version or tag "nope" found for package: payload');
+    });
+});
+describe('DEFAULT_PAYLOAD_VERSION_TAG', ()=>{
+    it('should export DEFAULT_PAYLOAD_VERSION_TAG as "canary"', ()=>{
+        expect(DEFAULT_PAYLOAD_VERSION_TAG).toBe('canary');
+    });
+});
+
+//# sourceMappingURL=resolvePackageVersion.spec.js.map

package/dist/utils/resolvePackageVersion.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/resolvePackageVersion.spec.ts"],"sourcesContent":["import { afterEach, describe, expect, it, vi } from 'vitest'\n\nimport { DEFAULT_PAYLOAD_VERSION_TAG, resolvePackageVersion } from './resolvePackageVersion.js'\n\nconst mockRegistry = ({\n  distTags,\n  validVersions = [],\n}: {\n  distTags: Record<string, string>\n  validVersions?: string[]\n}) =>\n  vi.stubGlobal(\n    'fetch',\n    vi.fn((url: string) => {\n      if (url.endsWith('/dist-tags')) {\n        return Promise.resolve({ json: () => Promise.resolve(distTags) })\n      }\n\n      const version = url.split('/').pop() ?? ''\n      return Promise.resolve({ status: validVersions.includes(version) ? 200 : 404 })\n    }),\n  )\n\ndescribe('resolvePackageVersion', () => {\n  afterEach(() => {\n    vi.unstubAllGlobals()\n    vi.restoreAllMocks()\n  })\n\n  it('should resolve a dist-tag to its concrete version', async () => {\n    mockRegistry({ distTags: { canary: '3.0.0-canary.abc', latest: '2.9.0' } })\n\n    const version = await resolvePackageVersion({ packageName: 'payload', versionOrTag: 'canary' })\n\n    expect(version).toBe('3.0.0-canary.abc')\n  })\n\n  it('should default to the latest tag when no value is provided', async () => {\n    mockRegistry({ distTags: { canary: '3.0.0-canary.abc', latest: '2.9.0' } })\n\n    const version = await resolvePackageVersion({ packageName: 'payload' })\n\n    expect(version).toBe('2.9.0')\n  })\n\n  it('should return an explicit version when it exists on the registry', async () => {\n    mockRegistry({ distTags: { latest: '2.9.0' }, validVersions: ['3.1.0'] })\n\n    const version = await resolvePackageVersion({ packageName: 'payload', versionOrTag: '3.1.0' })\n\n    expect(version).toBe('3.1.0')\n  })\n\n  it('should throw a clear error when neither a tag nor a version is found', async () => {\n    mockRegistry({ distTags: { latest: '2.9.0' } })\n\n    await expect(\n      resolvePackageVersion({ packageName: 'payload', versionOrTag: 'nope' }),\n    ).rejects.toThrow('No version or tag \"nope\" found for package: payload')\n  })\n})\n\ndescribe('DEFAULT_PAYLOAD_VERSION_TAG', () => {\n  it('should export DEFAULT_PAYLOAD_VERSION_TAG as \"canary\"', () => {\n    expect(DEFAULT_PAYLOAD_VERSION_TAG).toBe('canary')\n  })\n})\n"],"names":["afterEach","describe","expect","it","vi","DEFAULT_PAYLOAD_VERSION_TAG","resolvePackageVersion","mockRegistry","distTags","validVersions","stubGlobal","fn","url","endsWith","Promise","resolve","json","version","split","pop","status","includes","unstubAllGlobals","restoreAllMocks","canary","latest","packageName","versionOrTag","toBe","rejects","toThrow"],"mappings":"AAAA,SAASA,SAAS,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,EAAEC,EAAE,QAAQ,SAAQ;AAE5D,SAASC,2BAA2B,EAAEC,qBAAqB,QAAQ,6BAA4B;AAE/F,MAAMC,eAAe,CAAC,EACpBC,QAAQ,EACRC,gBAAgB,EAAE,EAInB,GACCL,GAAGM,UAAU,CACX,SACAN,GAAGO,EAAE,CAAC,CAACC;QACL,IAAIA,IAAIC,QAAQ,CAAC,eAAe;YAC9B,OAAOC,QAAQC,OAAO,CAAC;gBAAEC,MAAM,IAAMF,QAAQC,OAAO,CAACP;YAAU;QACjE;QAEA,MAAMS,UAAUL,IAAIM,KAAK,CAAC,KAAKC,GAAG,MAAM;QACxC,OAAOL,QAAQC,OAAO,CAAC;YAAEK,QAAQX,cAAcY,QAAQ,CAACJ,WAAW,MAAM;QAAI;IAC/E;AAGJhB,SAAS,yBAAyB;IAChCD,UAAU;QACRI,GAAGkB,gBAAgB;QACnBlB,GAAGmB,eAAe;IACpB;IAEApB,GAAG,qDAAqD;QACtDI,aAAa;YAAEC,UAAU;gBAAEgB,QAAQ;gBAAoBC,QAAQ;YAAQ;QAAE;QAEzE,MAAMR,UAAU,MAAMX,sBAAsB;YAAEoB,aAAa;YAAWC,cAAc;QAAS;QAE7FzB,OAAOe,SAASW,IAAI,CAAC;IACvB;IAEAzB,GAAG,8DAA8D;QAC/DI,aAAa;YAAEC,UAAU;gBAAEgB,QAAQ;gBAAoBC,QAAQ;YAAQ;QAAE;QAEzE,MAAMR,UAAU,MAAMX,sBAAsB;YAAEoB,aAAa;QAAU;QAErExB,OAAOe,SAASW,IAAI,CAAC;IACvB;IAEAzB,GAAG,oEAAoE;QACrEI,aAAa;YAAEC,UAAU;gBAAEiB,QAAQ;YAAQ;YAAGhB,eAAe;gBAAC;aAAQ;QAAC;QAEvE,MAAMQ,UAAU,MAAMX,sBAAsB;YAAEoB,aAAa;YAAWC,cAAc;QAAQ;QAE5FzB,OAAOe,SAASW,IAAI,CAAC;IACvB;IAEAzB,GAAG,wEAAwE;QACzEI,aAAa;YAAEC,UAAU;gBAAEiB,QAAQ;YAAQ;QAAE;QAE7C,MAAMvB,OACJI,sBAAsB;YAAEoB,aAAa;YAAWC,cAAc;QAAO,IACrEE,OAAO,CAACC,OAAO,CAAC;IACpB;AACF;AAEA7B,SAAS,+BAA+B;IACtCE,GAAG,yDAAyD;QAC1DD,OAAOG,6BAA6BuB,IAAI,CAAC;IAC3C;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-payload-app",
-  "version": "4.0.0-internal.5f0cd13",
+  "version": "4.0.0-internal.688c4d0",
   "homepage": "https://payloadcms.com",
   "repository": {
     "type": "git",
@@ -80,7 +80,7 @@
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "pack-template-files": "node --no-deprecation --import @swc-node/register/esm-register src/scripts/pack-template-files.ts",
-    "test": "jest",
+    "test": "vitest --run",
     "typecheck": "tsc"
   }
 }

package/dist/utils/getLatestPackageVersion.d.ts

@@ -1,17 +0,0 @@
-/**
- * Fetches the latest version of a package from the NPM registry.
- *
- * Used in determining the latest version of Payload to use in the generated templates.
- */
-export declare function getLatestPackageVersion({ debug, packageName, }: {
-    debug?: boolean;
-    /**
-     * Package name to fetch the latest version for based on the NPM registry URL
-     *
-     * Eg. for `'payload'`, it will fetch the version from `https://registry.npmjs.org/payload`
-     *
-     * @default 'payload'
-     */
-    packageName?: string;
-}): Promise<string>;
-//# sourceMappingURL=getLatestPackageVersion.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"getLatestPackageVersion.d.ts","sourceRoot":"","sources":["../../src/utils/getLatestPackageVersion.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,EAC5C,KAAa,EACb,WAAuB,GACxB,EAAE;IACD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,mBAeA"}

package/dist/utils/getLatestPackageVersion.js

@@ -1,20 +0,0 @@
-/**
- * Fetches the latest version of a package from the NPM registry.
- *
- * Used in determining the latest version of Payload to use in the generated templates.
- */ export async function getLatestPackageVersion({ debug = false, packageName = 'payload' }) {
-    try {
-        const response = await fetch(`https://registry.npmjs.org/${packageName}`);
-        const data = await response.json();
-        const latestVersion = data['dist-tags'].latest;
-        if (debug) {
-            console.log(`Found latest version of ${packageName}: ${latestVersion}`);
-        }
-        return latestVersion;
-    } catch (error) {
-        console.error('Error fetching Payload version:', error);
-        throw error;
-    }
-}
-
-//# sourceMappingURL=getLatestPackageVersion.js.map