chore(cpa): updates .env.example env vars along side .env vars based on selected DB (#9757)

### What?

Previously, the create-payload-app install would properly update the env
vars in the new created `.env` file but kept outdated env vars in the
`.env.example` file.

I.e

If selecting a `postgres` DB for the blank or website template:

`.env` --> `DATABASE_URI` -->
`postgres://postgres:<password>@127.0.0.1:5432/test-cpa`

`.env.example` --> `DATABASE_URI` -->
`mongodb://127.0.0.1/payload-template-blank-3-0`

### Now

`.env` --> `DATABASE_URI` -->
`postgres://postgres:<password>@127.0.0.1:5432/test-cpa`

`.env.example` --> `DATABASE_URI` -->
`postgres://postgres:<password>@127.0.0.1:5432/test-cpa`

Author: PatrikKozak

packages/create-payload-app/src/lib/manage-env-files.ts

@@ -0,0 +1,102 @@
+import fs from 'fs-extra'
+import path from 'path'
+
+import type { CliArgs, DbType, ProjectTemplate } from '../types.js'
+
+import { debug, error } from '../utils/log.js'
+
+const updateEnvVariables = (
+  contents: string,
+  databaseType: DbType | undefined,
+  databaseUri: string,
+  payloadSecret: string,
+): string => {
+  return contents
+    .split('\n')
+    .filter((e) => e)
+    .map((line) => {
+      if (line.startsWith('#') || !line.includes('=')) {
+        return line
+      }
+
+      const [key, ...valueParts] = line.split('=')
+      let value = valueParts.join('=')
+
+      if (
+        key === 'MONGODB_URI' ||
+        key === 'MONGO_URL' ||
+        key === 'DATABASE_URI' ||
+        key === 'POSTGRES_URL'
+      ) {
+        value = databaseUri
+        if (databaseType === 'vercel-postgres') {
+          value = databaseUri
+        }
+      }
+
+      if (key === 'PAYLOAD_SECRET' || key === 'PAYLOAD_SECRET_KEY') {
+        value = payloadSecret
+      }
+
+      return `${key}=${value}`
+    })
+    .join('\n')
+}
+
+/** Parse and swap .env.example values and write .env */
+export async function manageEnvFiles(args: {
+  cliArgs: CliArgs
+  databaseType?: DbType
+  databaseUri: string
+  payloadSecret: string
+  projectDir: string
+  template?: ProjectTemplate
+}): Promise<void> {
+  const { cliArgs, databaseType, databaseUri, payloadSecret, projectDir, template } = args
+
+  if (cliArgs['--dry-run']) {
+    debug(`DRY RUN: Environment files managed`)
+    return
+  }
+
+  const envExamplePath = path.join(projectDir, '.env.example')
+  const envPath = path.join(projectDir, '.env')
+
+  try {
+    let updatedExampleContents: string
+
+    if (template?.type === 'starter') {
+      if (!fs.existsSync(envExamplePath)) {
+        error(`.env.example file not found at ${envExamplePath}`)
+        process.exit(1)
+      }
+
+      const envExampleContents = await fs.readFile(envExamplePath, 'utf8')
+      updatedExampleContents = updateEnvVariables(
+        envExampleContents,
+        databaseType,
+        databaseUri,
+        payloadSecret,
+      )
+
+      await fs.writeFile(envExamplePath, updatedExampleContents)
+      debug(`.env.example file successfully updated`)
+    } else {
+      updatedExampleContents = `# Added by Payload\nDATABASE_URI=${databaseUri}\nPAYLOAD_SECRET=${payloadSecret}\n`
+    }
+
+    const existingEnvContents = fs.existsSync(envPath) ? await fs.readFile(envPath, 'utf8') : ''
+    const updatedEnvContents = existingEnvContents
+      ? `${existingEnvContents}\n# Added by Payload\n${updatedExampleContents}`
+      : `# Added by Payload\n${updatedExampleContents}`
+
+    await fs.writeFile(envPath, updatedEnvContents)
+    debug(`.env file successfully created or updated`)
+  } catch (err: unknown) {
+    error('Unable to manage environment files')
+    if (err instanceof Error) {
+      error(err.message)
+    }
+    process.exit(1)
+  }
+}

packages/create-payload-app/src/lib/write-env-file.ts

@@ -13,12 +13,12 @@ import { createProject } from './lib/create-project.js'
 import { generateSecret } from './lib/generate-secret.js'
 import { getPackageManager } from './lib/get-package-manager.js'
 import { getNextAppDetails, initNext } from './lib/init-next.js'
+import { manageEnvFiles } from './lib/manage-env-files.js'
 import { parseProjectName } from './lib/parse-project-name.js'
 import { parseTemplate } from './lib/parse-template.js'
 import { selectDb } from './lib/select-db.js'
 import { getValidTemplates, validateTemplate } from './lib/templates.js'
 import { updatePayloadInProject } from './lib/update-payload-in-project.js'
-import { writeEnvFile } from './lib/write-env-file.js'
 import { debug, error, info } from './utils/log.js'
 import {
   feedbackOutro,
@@ -181,7 +181,7 @@ export class Main {
           },
         })
 
-        await writeEnvFile({
+        await manageEnvFiles({
           cliArgs: this.args,
           databaseType: dbDetails.type,
           databaseUri: dbDetails.dbUri,
@@ -230,6 +230,7 @@ export class Main {
         case 'starter': {
           const dbDetails = await selectDb(this.args, projectName)
           const payloadSecret = generateSecret()
+
           await createProject({
             cliArgs: this.args,
             dbDetails,
@@ -238,14 +239,16 @@ export class Main {
             projectName,
             template,
           })
-          await writeEnvFile({
+
+          await manageEnvFiles({
             cliArgs: this.args,
             databaseType: dbDetails.type,
             databaseUri: dbDetails.dbUri,
             payloadSecret,
             projectDir,
             template,
           })
+
           break
         }
       }