@payloadcms/figma 0.0.1-alpha.0

package/dist/utils/config.js

@@ -0,0 +1,78 @@
+/**
+ * Configuration file management utilities
+ */ import fs from 'fs/promises';
+import path from 'path';
+const CONFIG_FILENAME = 'figma.config.json';
+const GITIGNORE_FILENAME = '.gitignore';
+/**
+ * Read figma.config.json from the current directory
+ *
+ * @param projectPath - Path to project directory (defaults to cwd)
+ * @returns Parsed configuration or null if not found
+ */ export async function readFigmaConfig(projectPath = process.cwd()) {
+    const configPath = path.join(projectPath, CONFIG_FILENAME);
+    try {
+        const content = await fs.readFile(configPath, 'utf-8');
+        return JSON.parse(content);
+    } catch (error) {
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        throw new Error(`Failed to read ${CONFIG_FILENAME}: ${error.message}`);
+    }
+}
+/**
+ * Write figma.config.json to the current directory
+ *
+ * @param config - Configuration to write
+ * @param projectPath - Path to project directory (defaults to cwd)
+ */ export async function writeFigmaConfig(config, projectPath = process.cwd()) {
+    const configPath = path.join(projectPath, CONFIG_FILENAME);
+    try {
+        const content = JSON.stringify(config, null, 2);
+        await fs.writeFile(configPath, content + '\n', 'utf-8');
+    } catch (error) {
+        throw new Error(`Failed to write ${CONFIG_FILENAME}: ${error.message}`);
+    }
+}
+/**
+ * Check if figma.config.json exists
+ *
+ * @param projectPath - Path to project directory (defaults to cwd)
+ * @returns True if config file exists
+ */ export async function hasFigmaConfig(projectPath = process.cwd()) {
+    const configPath = path.join(projectPath, CONFIG_FILENAME);
+    try {
+        await fs.access(configPath);
+        return true;
+    } catch  {
+        return false;
+    }
+}
+/**
+ * Ensure .gitignore exists and optionally add entries
+ *
+ * @param projectPath - Path to project directory
+ * @param entries - Optional entries to add to .gitignore
+ */ export async function ensureGitignore(projectPath, entries = []) {
+    const gitignorePath = path.join(projectPath, GITIGNORE_FILENAME);
+    let existingContent = '';
+    try {
+        existingContent = await fs.readFile(gitignorePath, 'utf-8');
+    } catch (error) {
+        if (error.code !== 'ENOENT') {
+            throw new Error(`Failed to read ${GITIGNORE_FILENAME}: ${error.message}`);
+        }
+    }
+    // Parse existing entries
+    const existingLines = existingContent.split('\n').filter((line)=>line.trim());
+    const existingSet = new Set(existingLines);
+    // Add new entries that don't exist
+    const newEntries = entries.filter((entry)=>!existingSet.has(entry));
+    if (newEntries.length > 0) {
+        const newContent = existingContent ? `${existingContent.trimEnd()}\n\n# Figma CMS\n${newEntries.join('\n')}\n` : `# Figma CMS\n${newEntries.join('\n')}\n`;
+        await fs.writeFile(gitignorePath, newContent, 'utf-8');
+    }
+}
+
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/config.ts"],"sourcesContent":["/**\n * Configuration file management utilities\n */\n\nimport fs from 'fs/promises'\nimport path from 'path'\n\nimport type { FigmaConfig } from '../types/config.js'\n\nconst CONFIG_FILENAME = 'figma.config.json'\nconst GITIGNORE_FILENAME = '.gitignore'\n\n/**\n * Read figma.config.json from the current directory\n *\n * @param projectPath - Path to project directory (defaults to cwd)\n * @returns Parsed configuration or null if not found\n */\nexport async function readFigmaConfig(\n  projectPath: string = process.cwd(),\n): Promise<FigmaConfig | null> {\n  const configPath = path.join(projectPath, CONFIG_FILENAME)\n\n  try {\n    const content = await fs.readFile(configPath, 'utf-8')\n    return JSON.parse(content) as FigmaConfig\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') {\n      return null\n    }\n    throw new Error(`Failed to read ${CONFIG_FILENAME}: ${(error as Error).message}`)\n  }\n}\n\n/**\n * Write figma.config.json to the current directory\n *\n * @param config - Configuration to write\n * @param projectPath - Path to project directory (defaults to cwd)\n */\nexport async function writeFigmaConfig(\n  config: FigmaConfig,\n  projectPath: string = process.cwd(),\n): Promise<void> {\n  const configPath = path.join(projectPath, CONFIG_FILENAME)\n\n  try {\n    const content = JSON.stringify(config, null, 2)\n    await fs.writeFile(configPath, content + '\\n', 'utf-8')\n  } catch (error) {\n    throw new Error(`Failed to write ${CONFIG_FILENAME}: ${(error as Error).message}`)\n  }\n}\n\n/**\n * Check if figma.config.json exists\n *\n * @param projectPath - Path to project directory (defaults to cwd)\n * @returns True if config file exists\n */\nexport async function hasFigmaConfig(projectPath: string = process.cwd()): Promise<boolean> {\n  const configPath = path.join(projectPath, CONFIG_FILENAME)\n\n  try {\n    await fs.access(configPath)\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * Ensure .gitignore exists and optionally add entries\n *\n * @param projectPath - Path to project directory\n * @param entries - Optional entries to add to .gitignore\n */\nexport async function ensureGitignore(projectPath: string, entries: string[] = []): Promise<void> {\n  const gitignorePath = path.join(projectPath, GITIGNORE_FILENAME)\n\n  let existingContent = ''\n  try {\n    existingContent = await fs.readFile(gitignorePath, 'utf-8')\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {\n      throw new Error(`Failed to read ${GITIGNORE_FILENAME}: ${(error as Error).message}`)\n    }\n  }\n\n  // Parse existing entries\n  const existingLines = existingContent.split('\\n').filter((line) => line.trim())\n  const existingSet = new Set(existingLines)\n\n  // Add new entries that don't exist\n  const newEntries = entries.filter((entry) => !existingSet.has(entry))\n\n  if (newEntries.length > 0) {\n    const newContent = existingContent\n      ? `${existingContent.trimEnd()}\\n\\n# Figma CMS\\n${newEntries.join('\\n')}\\n`\n      : `# Figma CMS\\n${newEntries.join('\\n')}\\n`\n\n    await fs.writeFile(gitignorePath, newContent, 'utf-8')\n  }\n}\n"],"names":["fs","path","CONFIG_FILENAME","GITIGNORE_FILENAME","readFigmaConfig","projectPath","process","cwd","configPath","join","content","readFile","JSON","parse","error","code","Error","message","writeFigmaConfig","config","stringify","writeFile","hasFigmaConfig","access","ensureGitignore","entries","gitignorePath","existingContent","existingLines","split","filter","line","trim","existingSet","Set","newEntries","entry","has","length","newContent","trimEnd"],"mappings":"AAAA;;CAEC,GAED,OAAOA,QAAQ,cAAa;AAC5B,OAAOC,UAAU,OAAM;AAIvB,MAAMC,kBAAkB;AACxB,MAAMC,qBAAqB;AAE3B;;;;;CAKC,GACD,OAAO,eAAeC,gBACpBC,cAAsBC,QAAQC,GAAG,EAAE;IAEnC,MAAMC,aAAaP,KAAKQ,IAAI,CAACJ,aAAaH;IAE1C,IAAI;QACF,MAAMQ,UAAU,MAAMV,GAAGW,QAAQ,CAACH,YAAY;QAC9C,OAAOI,KAAKC,KAAK,CAACH;IACpB,EAAE,OAAOI,OAAO;QACd,IAAI,AAACA,MAAgCC,IAAI,KAAK,UAAU;YACtD,OAAO;QACT;QACA,MAAM,IAAIC,MAAM,CAAC,eAAe,EAAEd,gBAAgB,EAAE,EAAE,AAACY,MAAgBG,OAAO,EAAE;IAClF;AACF;AAEA;;;;;CAKC,GACD,OAAO,eAAeC,iBACpBC,MAAmB,EACnBd,cAAsBC,QAAQC,GAAG,EAAE;IAEnC,MAAMC,aAAaP,KAAKQ,IAAI,CAACJ,aAAaH;IAE1C,IAAI;QACF,MAAMQ,UAAUE,KAAKQ,SAAS,CAACD,QAAQ,MAAM;QAC7C,MAAMnB,GAAGqB,SAAS,CAACb,YAAYE,UAAU,MAAM;IACjD,EAAE,OAAOI,OAAO;QACd,MAAM,IAAIE,MAAM,CAAC,gBAAgB,EAAEd,gBAAgB,EAAE,EAAE,AAACY,MAAgBG,OAAO,EAAE;IACnF;AACF;AAEA;;;;;CAKC,GACD,OAAO,eAAeK,eAAejB,cAAsBC,QAAQC,GAAG,EAAE;IACtE,MAAMC,aAAaP,KAAKQ,IAAI,CAACJ,aAAaH;IAE1C,IAAI;QACF,MAAMF,GAAGuB,MAAM,CAACf;QAChB,OAAO;IACT,EAAE,OAAM;QACN,OAAO;IACT;AACF;AAEA;;;;;CAKC,GACD,OAAO,eAAegB,gBAAgBnB,WAAmB,EAAEoB,UAAoB,EAAE;IAC/E,MAAMC,gBAAgBzB,KAAKQ,IAAI,CAACJ,aAAaF;IAE7C,IAAIwB,kBAAkB;IACtB,IAAI;QACFA,kBAAkB,MAAM3B,GAAGW,QAAQ,CAACe,eAAe;IACrD,EAAE,OAAOZ,OAAO;QACd,IAAI,AAACA,MAAgCC,IAAI,KAAK,UAAU;YACtD,MAAM,IAAIC,MAAM,CAAC,eAAe,EAAEb,mBAAmB,EAAE,EAAE,AAACW,MAAgBG,OAAO,EAAE;QACrF;IACF;IAEA,yBAAyB;IACzB,MAAMW,gBAAgBD,gBAAgBE,KAAK,CAAC,MAAMC,MAAM,CAAC,CAACC,OAASA,KAAKC,IAAI;IAC5E,MAAMC,cAAc,IAAIC,IAAIN;IAE5B,mCAAmC;IACnC,MAAMO,aAAaV,QAAQK,MAAM,CAAC,CAACM,QAAU,CAACH,YAAYI,GAAG,CAACD;IAE9D,IAAID,WAAWG,MAAM,GAAG,GAAG;QACzB,MAAMC,aAAaZ,kBACf,GAAGA,gBAAgBa,OAAO,GAAG,iBAAiB,EAAEL,WAAW1B,IAAI,CAAC,MAAM,EAAE,CAAC,GACzE,CAAC,aAAa,EAAE0B,WAAW1B,IAAI,CAAC,MAAM,EAAE,CAAC;QAE7C,MAAMT,GAAGqB,SAAS,CAACK,eAAea,YAAY;IAChD;AACF"}

package/dist/utils/config.spec.d.ts

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

package/dist/utils/config.spec.d.ts.map

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

package/dist/utils/config.spec.js

@@ -0,0 +1,167 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { ensureGitignore, hasFigmaConfig, readFigmaConfig, writeFigmaConfig } from './config.js';
+describe('config utilities', ()=>{
+    let testDir;
+    beforeEach(async ()=>{
+        // Create unique temp directory for each test
+        testDir = path.join(process.cwd(), '.test-tmp', `config-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`);
+        await fs.mkdir(testDir, {
+            recursive: true
+        });
+    });
+    afterEach(async ()=>{
+        // Clean up test directory
+        try {
+            await fs.rm(testDir, {
+                force: true,
+                recursive: true
+            });
+        } catch  {
+        // Ignore cleanup errors
+        }
+    });
+    describe('writeFigmaConfig', ()=>{
+        it('should write config to figma.config.json', async ()=>{
+            const config = {
+                domain: 'test-cms.figmacms.com',
+                tenantId: 'tenant_test123'
+            };
+            await writeFigmaConfig(config, testDir);
+            const filePath = path.join(testDir, 'figma.config.json');
+            const content = await fs.readFile(filePath, 'utf-8');
+            const parsed = JSON.parse(content);
+            expect(parsed).toEqual(config);
+        });
+        it('should format JSON with 2 space indentation', async ()=>{
+            const config = {
+                domain: 'format.figmacms.com',
+                tenantId: 'tenant_format'
+            };
+            await writeFigmaConfig(config, testDir);
+            const filePath = path.join(testDir, 'figma.config.json');
+            const content = await fs.readFile(filePath, 'utf-8');
+            // Check indentation
+            expect(content).toContain('  "tenantId"');
+            expect(content).toContain('  "domain"');
+        });
+        it('should include subdomain when provided', async ()=>{
+            const config = {
+                domain: 'sub.figmacms.com',
+                subdomain: 'custom',
+                tenantId: 'tenant_sub'
+            };
+            await writeFigmaConfig(config, testDir);
+            const read = await readFigmaConfig(testDir);
+            expect(read?.subdomain).toBe('custom');
+        });
+        it('should throw error if directory does not exist', async ()=>{
+            const config = {
+                domain: 'fail.figmacms.com',
+                tenantId: 'tenant_fail'
+            };
+            const nonExistentDir = path.join(testDir, 'does-not-exist');
+            await expect(writeFigmaConfig(config, nonExistentDir)).rejects.toThrow();
+        });
+    });
+    describe('readFigmaConfig', ()=>{
+        it('should read existing config', async ()=>{
+            const config = {
+                domain: 'read.figmacms.com',
+                tenantId: 'tenant_read'
+            };
+            await writeFigmaConfig(config, testDir);
+            const read = await readFigmaConfig(testDir);
+            expect(read).toEqual(config);
+        });
+        it('should return null if config does not exist', async ()=>{
+            const read = await readFigmaConfig(testDir);
+            expect(read).toBeNull();
+        });
+        it('should throw error if config is invalid JSON', async ()=>{
+            const filePath = path.join(testDir, 'figma.config.json');
+            await fs.writeFile(filePath, 'not valid json{', 'utf-8');
+            await expect(readFigmaConfig(testDir)).rejects.toThrow('Failed to read figma.config.json');
+        });
+        it('should handle config with all optional fields', async ()=>{
+            const config = {
+                domain: 'full.figmacms.com',
+                subdomain: 'custom-sub',
+                tenantId: 'tenant_full'
+            };
+            await writeFigmaConfig(config, testDir);
+            const read = await readFigmaConfig(testDir);
+            expect(read).toEqual(config);
+        });
+    });
+    describe('hasFigmaConfig', ()=>{
+        it('should return true if config exists', async ()=>{
+            const config = {
+                domain: 'has.figmacms.com',
+                tenantId: 'tenant_has'
+            };
+            await writeFigmaConfig(config, testDir);
+            const has = await hasFigmaConfig(testDir);
+            expect(has).toBe(true);
+        });
+        it('should return false if config does not exist', async ()=>{
+            const has = await hasFigmaConfig(testDir);
+            expect(has).toBe(false);
+        });
+        it('should handle directory that does not exist', async ()=>{
+            const nonExistentDir = path.join(testDir, 'does-not-exist');
+            const has = await hasFigmaConfig(nonExistentDir);
+            expect(has).toBe(false);
+        });
+    });
+    describe('ensureGitignore', ()=>{
+        it('should create .gitignore if it does not exist', async ()=>{
+            await ensureGitignore(testDir, [
+                'node_modules',
+                '.env'
+            ]);
+            const filePath = path.join(testDir, '.gitignore');
+            const content = await fs.readFile(filePath, 'utf-8');
+            expect(content).toContain('node_modules');
+            expect(content).toContain('.env');
+            expect(content).toContain('# Figma CMS');
+        });
+        it('should append to existing .gitignore', async ()=>{
+            const filePath = path.join(testDir, '.gitignore');
+            await fs.writeFile(filePath, '# Existing content\ndist\n', 'utf-8');
+            await ensureGitignore(testDir, [
+                'node_modules'
+            ]);
+            const content = await fs.readFile(filePath, 'utf-8');
+            expect(content).toContain('# Existing content');
+            expect(content).toContain('dist');
+            expect(content).toContain('node_modules');
+            expect(content).toContain('# Figma CMS');
+        });
+        it('should not add duplicate entries', async ()=>{
+            await ensureGitignore(testDir, [
+                'node_modules',
+                '.env'
+            ]);
+            await ensureGitignore(testDir, [
+                'node_modules',
+                'dist'
+            ]);
+            const filePath = path.join(testDir, '.gitignore');
+            const content = await fs.readFile(filePath, 'utf-8');
+            // Count occurrences of node_modules
+            const matches = content.match(/node_modules/g);
+            expect(matches?.length).toBe(1);
+        });
+        it('should handle empty entries array', async ()=>{
+            await ensureGitignore(testDir, []);
+            const filePath = path.join(testDir, '.gitignore');
+            const exists = await fs.access(filePath).then(()=>true).catch(()=>false);
+            // Should not create file if no entries to add
+            expect(exists).toBe(false);
+        });
+    });
+});
+
+//# sourceMappingURL=config.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/config.spec.ts"],"sourcesContent":["import fs from 'fs/promises'\nimport path from 'path'\nimport { afterEach, beforeEach, describe, expect, it } from 'vitest'\n\nimport type { FigmaConfig } from '../types/config.js'\n\nimport { ensureGitignore, hasFigmaConfig, readFigmaConfig, writeFigmaConfig } from './config.js'\n\ndescribe('config utilities', () => {\n  let testDir: string\n\n  beforeEach(async () => {\n    // Create unique temp directory for each test\n    testDir = path.join(\n      process.cwd(),\n      '.test-tmp',\n      `config-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`,\n    )\n    await fs.mkdir(testDir, { recursive: true })\n  })\n\n  afterEach(async () => {\n    // Clean up test directory\n    try {\n      await fs.rm(testDir, { force: true, recursive: true })\n    } catch {\n      // Ignore cleanup errors\n    }\n  })\n\n  describe('writeFigmaConfig', () => {\n    it('should write config to figma.config.json', async () => {\n      const config: FigmaConfig = {\n        domain: 'test-cms.figmacms.com',\n        tenantId: 'tenant_test123',\n      }\n\n      await writeFigmaConfig(config, testDir)\n\n      const filePath = path.join(testDir, 'figma.config.json')\n      const content = await fs.readFile(filePath, 'utf-8')\n      const parsed = JSON.parse(content)\n\n      expect(parsed).toEqual(config)\n    })\n\n    it('should format JSON with 2 space indentation', async () => {\n      const config: FigmaConfig = {\n        domain: 'format.figmacms.com',\n        tenantId: 'tenant_format',\n      }\n\n      await writeFigmaConfig(config, testDir)\n\n      const filePath = path.join(testDir, 'figma.config.json')\n      const content = await fs.readFile(filePath, 'utf-8')\n\n      // Check indentation\n      expect(content).toContain('  \"tenantId\"')\n      expect(content).toContain('  \"domain\"')\n    })\n\n    it('should include subdomain when provided', async () => {\n      const config: FigmaConfig = {\n        domain: 'sub.figmacms.com',\n        subdomain: 'custom',\n        tenantId: 'tenant_sub',\n      }\n\n      await writeFigmaConfig(config, testDir)\n\n      const read = await readFigmaConfig(testDir)\n      expect(read?.subdomain).toBe('custom')\n    })\n\n    it('should throw error if directory does not exist', async () => {\n      const config: FigmaConfig = {\n        domain: 'fail.figmacms.com',\n        tenantId: 'tenant_fail',\n      }\n\n      const nonExistentDir = path.join(testDir, 'does-not-exist')\n\n      await expect(writeFigmaConfig(config, nonExistentDir)).rejects.toThrow()\n    })\n  })\n\n  describe('readFigmaConfig', () => {\n    it('should read existing config', async () => {\n      const config: FigmaConfig = {\n        domain: 'read.figmacms.com',\n        tenantId: 'tenant_read',\n      }\n\n      await writeFigmaConfig(config, testDir)\n\n      const read = await readFigmaConfig(testDir)\n\n      expect(read).toEqual(config)\n    })\n\n    it('should return null if config does not exist', async () => {\n      const read = await readFigmaConfig(testDir)\n\n      expect(read).toBeNull()\n    })\n\n    it('should throw error if config is invalid JSON', async () => {\n      const filePath = path.join(testDir, 'figma.config.json')\n      await fs.writeFile(filePath, 'not valid json{', 'utf-8')\n\n      await expect(readFigmaConfig(testDir)).rejects.toThrow('Failed to read figma.config.json')\n    })\n\n    it('should handle config with all optional fields', async () => {\n      const config: FigmaConfig = {\n        domain: 'full.figmacms.com',\n        subdomain: 'custom-sub',\n        tenantId: 'tenant_full',\n      }\n\n      await writeFigmaConfig(config, testDir)\n      const read = await readFigmaConfig(testDir)\n\n      expect(read).toEqual(config)\n    })\n  })\n\n  describe('hasFigmaConfig', () => {\n    it('should return true if config exists', async () => {\n      const config: FigmaConfig = {\n        domain: 'has.figmacms.com',\n        tenantId: 'tenant_has',\n      }\n\n      await writeFigmaConfig(config, testDir)\n\n      const has = await hasFigmaConfig(testDir)\n\n      expect(has).toBe(true)\n    })\n\n    it('should return false if config does not exist', async () => {\n      const has = await hasFigmaConfig(testDir)\n\n      expect(has).toBe(false)\n    })\n\n    it('should handle directory that does not exist', async () => {\n      const nonExistentDir = path.join(testDir, 'does-not-exist')\n\n      const has = await hasFigmaConfig(nonExistentDir)\n\n      expect(has).toBe(false)\n    })\n  })\n\n  describe('ensureGitignore', () => {\n    it('should create .gitignore if it does not exist', async () => {\n      await ensureGitignore(testDir, ['node_modules', '.env'])\n\n      const filePath = path.join(testDir, '.gitignore')\n      const content = await fs.readFile(filePath, 'utf-8')\n\n      expect(content).toContain('node_modules')\n      expect(content).toContain('.env')\n      expect(content).toContain('# Figma CMS')\n    })\n\n    it('should append to existing .gitignore', async () => {\n      const filePath = path.join(testDir, '.gitignore')\n      await fs.writeFile(filePath, '# Existing content\\ndist\\n', 'utf-8')\n\n      await ensureGitignore(testDir, ['node_modules'])\n\n      const content = await fs.readFile(filePath, 'utf-8')\n\n      expect(content).toContain('# Existing content')\n      expect(content).toContain('dist')\n      expect(content).toContain('node_modules')\n      expect(content).toContain('# Figma CMS')\n    })\n\n    it('should not add duplicate entries', async () => {\n      await ensureGitignore(testDir, ['node_modules', '.env'])\n      await ensureGitignore(testDir, ['node_modules', 'dist'])\n\n      const filePath = path.join(testDir, '.gitignore')\n      const content = await fs.readFile(filePath, 'utf-8')\n\n      // Count occurrences of node_modules\n      const matches = content.match(/node_modules/g)\n      expect(matches?.length).toBe(1)\n    })\n\n    it('should handle empty entries array', async () => {\n      await ensureGitignore(testDir, [])\n\n      const filePath = path.join(testDir, '.gitignore')\n      const exists = await fs\n        .access(filePath)\n        .then(() => true)\n        .catch(() => false)\n\n      // Should not create file if no entries to add\n      expect(exists).toBe(false)\n    })\n  })\n})\n"],"names":["fs","path","afterEach","beforeEach","describe","expect","it","ensureGitignore","hasFigmaConfig","readFigmaConfig","writeFigmaConfig","testDir","join","process","cwd","Date","now","Math","random","toString","substring","mkdir","recursive","rm","force","config","domain","tenantId","filePath","content","readFile","parsed","JSON","parse","toEqual","toContain","subdomain","read","toBe","nonExistentDir","rejects","toThrow","toBeNull","writeFile","has","matches","match","length","exists","access","then","catch"],"mappings":"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"}

package/dist/utils/download-template.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Error thrown when template download fails
+ */
+export declare class TemplateDownloadError extends Error {
+    cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Download Payload template from GitHub with retry logic
+ *
+ * @param projectDir - Directory to extract template into
+ * @throws TemplateDownloadError if download fails
+ */
+export declare function downloadTemplateFromGitHub(projectDir: string): Promise<void>;
+//# sourceMappingURL=download-template.d.ts.map

package/dist/utils/download-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-template.d.ts","sourceRoot":"","sources":["../../src/utils/download-template.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAGrC,KAAK,CAAC,EAAE,KAAK;gBADpB,OAAO,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,KAAK,YAAA;CAKvB;AAOD;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBlF"}

package/dist/utils/download-template.js

@@ -0,0 +1,74 @@
+import fs from 'node:fs/promises';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { x } from 'tar';
+/**
+ * Error thrown when template download fails
+ */ export class TemplateDownloadError extends Error {
+    cause;
+    constructor(message, cause){
+        super(message), this.cause = cause;
+        this.name = 'TemplateDownloadError';
+    }
+}
+const BRANCH_OR_TAG = 'main';
+const TEMPLATE_NAME = 'blank';
+const MAX_RETRIES = 3;
+const INITIAL_RETRY_DELAY = 1000 // 1 second
+;
+/**
+ * Download Payload template from GitHub with retry logic
+ *
+ * @param projectDir - Directory to extract template into
+ * @throws TemplateDownloadError if download fails
+ */ export async function downloadTemplateFromGitHub(projectDir) {
+    let lastError;
+    for(let attempt = 1; attempt <= MAX_RETRIES; attempt++){
+        try {
+            await downloadTemplateAttempt(projectDir);
+            return; // Success
+        } catch (error) {
+            lastError = error instanceof Error ? error : new Error('Unknown error');
+            if (attempt < MAX_RETRIES) {
+                // Exponential backoff: 1s, 2s, 4s
+                const delay = INITIAL_RETRY_DELAY * Math.pow(2, attempt - 1);
+                await new Promise((resolve)=>setTimeout(resolve, delay));
+            }
+        }
+    }
+    // All retries failed
+    throw new TemplateDownloadError(`Failed to download template after ${MAX_RETRIES} attempts`, lastError);
+}
+/**
+ * Single attempt to download template (extracted for retry logic)
+ */ async function downloadTemplateAttempt(projectDir) {
+    const url = `https://codeload.github.com/payloadcms/payload/tar.gz/${BRANCH_OR_TAG}`;
+    const filter = `payload-${BRANCH_OR_TAG}/templates/${TEMPLATE_NAME}/`;
+    try {
+        // Ensure target directory exists
+        await fs.mkdir(projectDir, {
+            recursive: true
+        });
+        await pipeline(await downloadTarStream(url), x({
+            cwd: projectDir,
+            filter: (p)=>p.includes(filter),
+            strip: 2 + TEMPLATE_NAME.split('/').length
+        }));
+    } catch (error) {
+        throw new TemplateDownloadError('Failed to download template from GitHub', error instanceof Error ? error : undefined);
+    }
+}
+/**
+ * Download tar stream from URL
+ */ async function downloadTarStream(url) {
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new Error(`HTTP ${res.status}: ${res.statusText}`);
+    }
+    if (!res.body) {
+        throw new Error(`Failed to download: ${url}`);
+    }
+    return Readable.from(res.body);
+}
+
+//# sourceMappingURL=download-template.js.map

package/dist/utils/download-template.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/download-template.ts"],"sourcesContent":["import fs from 'node:fs/promises'\nimport { Readable } from 'node:stream'\nimport { pipeline } from 'node:stream/promises'\nimport { x } from 'tar'\n\n/**\n * Error thrown when template download fails\n */\nexport class TemplateDownloadError extends Error {\n  constructor(\n    message: string,\n    public cause?: Error,\n  ) {\n    super(message)\n    this.name = 'TemplateDownloadError'\n  }\n}\n\nconst BRANCH_OR_TAG = 'main'\nconst TEMPLATE_NAME = 'blank'\nconst MAX_RETRIES = 3\nconst INITIAL_RETRY_DELAY = 1000 // 1 second\n\n/**\n * Download Payload template from GitHub with retry logic\n *\n * @param projectDir - Directory to extract template into\n * @throws TemplateDownloadError if download fails\n */\nexport async function downloadTemplateFromGitHub(projectDir: string): Promise<void> {\n  let lastError: Error | undefined\n\n  for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {\n    try {\n      await downloadTemplateAttempt(projectDir)\n      return // Success\n    } catch (error) {\n      lastError = error instanceof Error ? error : new Error('Unknown error')\n\n      if (attempt < MAX_RETRIES) {\n        // Exponential backoff: 1s, 2s, 4s\n        const delay = INITIAL_RETRY_DELAY * Math.pow(2, attempt - 1)\n        await new Promise((resolve) => setTimeout(resolve, delay))\n      }\n    }\n  }\n\n  // All retries failed\n  throw new TemplateDownloadError(\n    `Failed to download template after ${MAX_RETRIES} attempts`,\n    lastError,\n  )\n}\n\n/**\n * Single attempt to download template (extracted for retry logic)\n */\nasync function downloadTemplateAttempt(projectDir: string): Promise<void> {\n  const url = `https://codeload.github.com/payloadcms/payload/tar.gz/${BRANCH_OR_TAG}`\n  const filter = `payload-${BRANCH_OR_TAG}/templates/${TEMPLATE_NAME}/`\n\n  try {\n    // Ensure target directory exists\n    await fs.mkdir(projectDir, { recursive: true })\n\n    await pipeline(\n      await downloadTarStream(url),\n      x({\n        cwd: projectDir,\n        filter: (p) => p.includes(filter),\n        strip: 2 + TEMPLATE_NAME.split('/').length,\n      }),\n    )\n  } catch (error) {\n    throw new TemplateDownloadError(\n      'Failed to download template from GitHub',\n      error instanceof Error ? error : undefined,\n    )\n  }\n}\n\n/**\n * Download tar stream from URL\n */\nasync function downloadTarStream(url: string): Promise<Readable> {\n  const res = await fetch(url)\n\n  if (!res.ok) {\n    throw new Error(`HTTP ${res.status}: ${res.statusText}`)\n  }\n\n  if (!res.body) {\n    throw new Error(`Failed to download: ${url}`)\n  }\n\n  return Readable.from(res.body as unknown as NodeJS.ReadableStream)\n}\n"],"names":["fs","Readable","pipeline","x","TemplateDownloadError","Error","message","cause","name","BRANCH_OR_TAG","TEMPLATE_NAME","MAX_RETRIES","INITIAL_RETRY_DELAY","downloadTemplateFromGitHub","projectDir","lastError","attempt","downloadTemplateAttempt","error","delay","Math","pow","Promise","resolve","setTimeout","url","filter","mkdir","recursive","downloadTarStream","cwd","p","includes","strip","split","length","undefined","res","fetch","ok","status","statusText","body","from"],"mappings":"AAAA,OAAOA,QAAQ,mBAAkB;AACjC,SAASC,QAAQ,QAAQ,cAAa;AACtC,SAASC,QAAQ,QAAQ,uBAAsB;AAC/C,SAASC,CAAC,QAAQ,MAAK;AAEvB;;CAEC,GACD,OAAO,MAAMC,8BAA8BC;;IACzC,YACEC,OAAe,EACf,AAAOC,KAAa,CACpB;QACA,KAAK,CAACD,eAFCC,QAAAA;QAGP,IAAI,CAACC,IAAI,GAAG;IACd;AACF;AAEA,MAAMC,gBAAgB;AACtB,MAAMC,gBAAgB;AACtB,MAAMC,cAAc;AACpB,MAAMC,sBAAsB,KAAK,WAAW;;AAE5C;;;;;CAKC,GACD,OAAO,eAAeC,2BAA2BC,UAAkB;IACjE,IAAIC;IAEJ,IAAK,IAAIC,UAAU,GAAGA,WAAWL,aAAaK,UAAW;QACvD,IAAI;YACF,MAAMC,wBAAwBH;YAC9B,QAAO,UAAU;QACnB,EAAE,OAAOI,OAAO;YACdH,YAAYG,iBAAiBb,QAAQa,QAAQ,IAAIb,MAAM;YAEvD,IAAIW,UAAUL,aAAa;gBACzB,kCAAkC;gBAClC,MAAMQ,QAAQP,sBAAsBQ,KAAKC,GAAG,CAAC,GAAGL,UAAU;gBAC1D,MAAM,IAAIM,QAAQ,CAACC,UAAYC,WAAWD,SAASJ;YACrD;QACF;IACF;IAEA,qBAAqB;IACrB,MAAM,IAAIf,sBACR,CAAC,kCAAkC,EAAEO,YAAY,SAAS,CAAC,EAC3DI;AAEJ;AAEA;;CAEC,GACD,eAAeE,wBAAwBH,UAAkB;IACvD,MAAMW,MAAM,CAAC,sDAAsD,EAAEhB,eAAe;IACpF,MAAMiB,SAAS,CAAC,QAAQ,EAAEjB,cAAc,WAAW,EAAEC,cAAc,CAAC,CAAC;IAErE,IAAI;QACF,iCAAiC;QACjC,MAAMV,GAAG2B,KAAK,CAACb,YAAY;YAAEc,WAAW;QAAK;QAE7C,MAAM1B,SACJ,MAAM2B,kBAAkBJ,MACxBtB,EAAE;YACA2B,KAAKhB;YACLY,QAAQ,CAACK,IAAMA,EAAEC,QAAQ,CAACN;YAC1BO,OAAO,IAAIvB,cAAcwB,KAAK,CAAC,KAAKC,MAAM;QAC5C;IAEJ,EAAE,OAAOjB,OAAO;QACd,MAAM,IAAId,sBACR,2CACAc,iBAAiBb,QAAQa,QAAQkB;IAErC;AACF;AAEA;;CAEC,GACD,eAAeP,kBAAkBJ,GAAW;IAC1C,MAAMY,MAAM,MAAMC,MAAMb;IAExB,IAAI,CAACY,IAAIE,EAAE,EAAE;QACX,MAAM,IAAIlC,MAAM,CAAC,KAAK,EAAEgC,IAAIG,MAAM,CAAC,EAAE,EAAEH,IAAII,UAAU,EAAE;IACzD;IAEA,IAAI,CAACJ,IAAIK,IAAI,EAAE;QACb,MAAM,IAAIrC,MAAM,CAAC,oBAAoB,EAAEoB,KAAK;IAC9C;IAEA,OAAOxB,SAAS0C,IAAI,CAACN,IAAIK,IAAI;AAC/B"}

package/dist/utils/download-template.spec.d.ts

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

package/dist/utils/download-template.spec.d.ts.map

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

package/dist/utils/download-template.spec.js

@@ -0,0 +1,76 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { downloadTemplateFromGitHub, TemplateDownloadError } from './download-template.js';
+describe('downloadTemplateFromGitHub', ()=>{
+    const testTempDir = path.join(process.cwd(), '.test-temp-download');
+    beforeEach(async ()=>{
+        await fs.mkdir(testTempDir, {
+            recursive: true
+        });
+    });
+    afterEach(async ()=>{
+        await fs.rm(testTempDir, {
+            force: true,
+            recursive: true
+        });
+    });
+    it('should download and extract template to target directory', async ()=>{
+        const targetDir = path.join(testTempDir, 'test-project');
+        await downloadTemplateFromGitHub(targetDir);
+        // Verify essential files exist
+        const packageJson = await fs.readFile(path.join(targetDir, 'package.json'), 'utf-8');
+        expect(packageJson).toContain('payload');
+    });
+});
+describe('downloadTemplateFromGitHub - retry logic', ()=>{
+    const testTempDir = path.join(process.cwd(), '.test-temp-download');
+    beforeEach(async ()=>{
+        await fs.mkdir(testTempDir, {
+            recursive: true
+        });
+    });
+    afterEach(async ()=>{
+        await fs.rm(testTempDir, {
+            force: true,
+            recursive: true
+        });
+        vi.restoreAllMocks();
+    });
+    it('should retry on network failure up to 3 times', async ()=>{
+        const targetDir = path.join(testTempDir, 'retry-test');
+        // Mock fetch to fail twice then succeed
+        let attemptCount = 0;
+        const originalFetch = global.fetch;
+        global.fetch = vi.fn(async (...args)=>{
+            attemptCount++;
+            if (attemptCount < 3) {
+                // Simulate network error
+                return {
+                    ok: false,
+                    status: 500,
+                    statusText: 'Server Error'
+                };
+            }
+            // Third attempt succeeds
+            return await originalFetch(...args);
+        });
+        await downloadTemplateFromGitHub(targetDir);
+        // Expect at least 3 calls (2 failures + 1 success)
+        expect(attemptCount).toBeGreaterThanOrEqual(3);
+    });
+    it('should throw error after 3 failed attempts', async ()=>{
+        const targetDir = path.join(testTempDir, 'fail-test');
+        // Mock fetch to always fail
+        global.fetch = vi.fn(()=>{
+            return Promise.resolve({
+                ok: false,
+                status: 500,
+                statusText: 'Server Error'
+            });
+        });
+        await expect(downloadTemplateFromGitHub(targetDir)).rejects.toThrow(TemplateDownloadError);
+    });
+});
+
+//# sourceMappingURL=download-template.spec.js.map

package/dist/utils/download-template.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/download-template.spec.ts"],"sourcesContent":["import fs from 'fs/promises'\nimport path from 'path'\nimport { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'\n\nimport { downloadTemplateFromGitHub, TemplateDownloadError } from './download-template.js'\n\ndescribe('downloadTemplateFromGitHub', () => {\n  const testTempDir = path.join(process.cwd(), '.test-temp-download')\n\n  beforeEach(async () => {\n    await fs.mkdir(testTempDir, { recursive: true })\n  })\n\n  afterEach(async () => {\n    await fs.rm(testTempDir, { force: true, recursive: true })\n  })\n\n  it('should download and extract template to target directory', async () => {\n    const targetDir = path.join(testTempDir, 'test-project')\n\n    await downloadTemplateFromGitHub(targetDir)\n\n    // Verify essential files exist\n    const packageJson = await fs.readFile(path.join(targetDir, 'package.json'), 'utf-8')\n    expect(packageJson).toContain('payload')\n  })\n})\n\ndescribe('downloadTemplateFromGitHub - retry logic', () => {\n  const testTempDir = path.join(process.cwd(), '.test-temp-download')\n\n  beforeEach(async () => {\n    await fs.mkdir(testTempDir, { recursive: true })\n  })\n\n  afterEach(async () => {\n    await fs.rm(testTempDir, { force: true, recursive: true })\n    vi.restoreAllMocks()\n  })\n\n  it('should retry on network failure up to 3 times', async () => {\n    const targetDir = path.join(testTempDir, 'retry-test')\n\n    // Mock fetch to fail twice then succeed\n    let attemptCount = 0\n    const originalFetch = global.fetch\n    global.fetch = vi.fn(async (...args: Parameters<typeof fetch>) => {\n      attemptCount++\n      if (attemptCount < 3) {\n        // Simulate network error\n        return {\n          ok: false,\n          status: 500,\n          statusText: 'Server Error',\n        } as Response\n      }\n      // Third attempt succeeds\n      return await originalFetch(...args)\n    })\n\n    await downloadTemplateFromGitHub(targetDir)\n\n    // Expect at least 3 calls (2 failures + 1 success)\n    expect(attemptCount).toBeGreaterThanOrEqual(3)\n  })\n\n  it('should throw error after 3 failed attempts', async () => {\n    const targetDir = path.join(testTempDir, 'fail-test')\n\n    // Mock fetch to always fail\n    global.fetch = vi.fn(() => {\n      return Promise.resolve({\n        ok: false,\n        status: 500,\n        statusText: 'Server Error',\n      } as Response)\n    })\n\n    await expect(downloadTemplateFromGitHub(targetDir)).rejects.toThrow(TemplateDownloadError)\n  })\n})\n"],"names":["fs","path","afterEach","beforeEach","describe","expect","it","vi","downloadTemplateFromGitHub","TemplateDownloadError","testTempDir","join","process","cwd","mkdir","recursive","rm","force","targetDir","packageJson","readFile","toContain","restoreAllMocks","attemptCount","originalFetch","global","fetch","fn","args","ok","status","statusText","toBeGreaterThanOrEqual","Promise","resolve","rejects","toThrow"],"mappings":"AAAA,OAAOA,QAAQ,cAAa;AAC5B,OAAOC,UAAU,OAAM;AACvB,SAASC,SAAS,EAAEC,UAAU,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,EAAEC,EAAE,QAAQ,SAAQ;AAExE,SAASC,0BAA0B,EAAEC,qBAAqB,QAAQ,yBAAwB;AAE1FL,SAAS,8BAA8B;IACrC,MAAMM,cAAcT,KAAKU,IAAI,CAACC,QAAQC,GAAG,IAAI;IAE7CV,WAAW;QACT,MAAMH,GAAGc,KAAK,CAACJ,aAAa;YAAEK,WAAW;QAAK;IAChD;IAEAb,UAAU;QACR,MAAMF,GAAGgB,EAAE,CAACN,aAAa;YAAEO,OAAO;YAAMF,WAAW;QAAK;IAC1D;IAEAT,GAAG,4DAA4D;QAC7D,MAAMY,YAAYjB,KAAKU,IAAI,CAACD,aAAa;QAEzC,MAAMF,2BAA2BU;QAEjC,+BAA+B;QAC/B,MAAMC,cAAc,MAAMnB,GAAGoB,QAAQ,CAACnB,KAAKU,IAAI,CAACO,WAAW,iBAAiB;QAC5Eb,OAAOc,aAAaE,SAAS,CAAC;IAChC;AACF;AAEAjB,SAAS,4CAA4C;IACnD,MAAMM,cAAcT,KAAKU,IAAI,CAACC,QAAQC,GAAG,IAAI;IAE7CV,WAAW;QACT,MAAMH,GAAGc,KAAK,CAACJ,aAAa;YAAEK,WAAW;QAAK;IAChD;IAEAb,UAAU;QACR,MAAMF,GAAGgB,EAAE,CAACN,aAAa;YAAEO,OAAO;YAAMF,WAAW;QAAK;QACxDR,GAAGe,eAAe;IACpB;IAEAhB,GAAG,iDAAiD;QAClD,MAAMY,YAAYjB,KAAKU,IAAI,CAACD,aAAa;QAEzC,wCAAwC;QACxC,IAAIa,eAAe;QACnB,MAAMC,gBAAgBC,OAAOC,KAAK;QAClCD,OAAOC,KAAK,GAAGnB,GAAGoB,EAAE,CAAC,OAAO,GAAGC;YAC7BL;YACA,IAAIA,eAAe,GAAG;gBACpB,yBAAyB;gBACzB,OAAO;oBACLM,IAAI;oBACJC,QAAQ;oBACRC,YAAY;gBACd;YACF;YACA,yBAAyB;YACzB,OAAO,MAAMP,iBAAiBI;QAChC;QAEA,MAAMpB,2BAA2BU;QAEjC,mDAAmD;QACnDb,OAAOkB,cAAcS,sBAAsB,CAAC;IAC9C;IAEA1B,GAAG,8CAA8C;QAC/C,MAAMY,YAAYjB,KAAKU,IAAI,CAACD,aAAa;QAEzC,4BAA4B;QAC5Be,OAAOC,KAAK,GAAGnB,GAAGoB,EAAE,CAAC;YACnB,OAAOM,QAAQC,OAAO,CAAC;gBACrBL,IAAI;gBACJC,QAAQ;gBACRC,YAAY;YACd;QACF;QAEA,MAAM1B,OAAOG,2BAA2BU,YAAYiB,OAAO,CAACC,OAAO,CAAC3B;IACtE;AACF"}

package/dist/utils/env-management.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generate a cryptographically secure secret for PAYLOAD_SECRET
+ *
+ * @returns 24-character hexadecimal string
+ */
+export declare function generateSecret(): string;
+/**
+ * Manage environment files for a new project
+ *
+ * Creates .env from .env.example (if exists) and populates PAYLOAD_SECRET
+ *
+ * @param projectPath - Path to project directory
+ * @returns The generated payload secret
+ */
+export declare function manageEnvFiles(projectPath: string): Promise<string>;
+//# sourceMappingURL=env-management.d.ts.map

package/dist/utils/env-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-management.d.ts","sourceRoot":"","sources":["../../src/utils/env-management.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAoDD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA8CzE"}

package/dist/utils/env-management.js

@@ -0,0 +1,98 @@
+import { randomBytes } from 'crypto';
+import fs from 'fs/promises';
+import path from 'path';
+/**
+ * Generate a cryptographically secure secret for PAYLOAD_SECRET
+ *
+ * @returns 24-character hexadecimal string
+ */ export function generateSecret() {
+    return randomBytes(32).toString('hex').slice(0, 24);
+}
+/**
+ * Sanitize and process environment file contents
+ *
+ * @param contents - Raw .env file contents
+ * @param payloadSecret - Secret to use for PAYLOAD_SECRET
+ * @returns Processed .env contents
+ */ function sanitizeEnv(contents, payloadSecret) {
+    const lines = contents.split('\n');
+    const seenKeys = new Set();
+    const processedLines = [];
+    for (const line of lines){
+        // Skip empty lines and comments
+        if (!line.trim() || line.trim().startsWith('#')) {
+            processedLines.push(line);
+            continue;
+        }
+        // Skip lines without =
+        if (!line.includes('=')) {
+            processedLines.push(line);
+            continue;
+        }
+        const [key] = line.split('=');
+        const trimmedKey = key.trim();
+        // Skip duplicate keys
+        if (seenKeys.has(trimmedKey)) {
+            continue;
+        }
+        seenKeys.add(trimmedKey);
+        // Replace PAYLOAD_SECRET with actual value
+        if (trimmedKey === 'PAYLOAD_SECRET' || trimmedKey === 'PAYLOAD_SECRET_KEY') {
+            processedLines.push(`PAYLOAD_SECRET=${payloadSecret}`);
+        } else {
+            processedLines.push(line);
+        }
+    }
+    // Add PAYLOAD_SECRET if not present
+    if (!seenKeys.has('PAYLOAD_SECRET') && !seenKeys.has('PAYLOAD_SECRET_KEY')) {
+        processedLines.push(`PAYLOAD_SECRET=${payloadSecret}`);
+    }
+    return processedLines.join('\n');
+}
+/**
+ * Manage environment files for a new project
+ *
+ * Creates .env from .env.example (if exists) and populates PAYLOAD_SECRET
+ *
+ * @param projectPath - Path to project directory
+ * @returns The generated payload secret
+ */ export async function manageEnvFiles(projectPath) {
+    const payloadSecret = generateSecret();
+    const envExamplePath = path.join(projectPath, '.env.example');
+    const envPath = path.join(projectPath, '.env');
+    try {
+        // Check if .env.example exists
+        let envExampleContents = '';
+        try {
+            envExampleContents = await fs.readFile(envExamplePath, 'utf-8');
+        } catch  {
+            // No .env.example, create minimal .env
+            envExampleContents = '';
+        }
+        // Check if .env already exists
+        let envExists = false;
+        try {
+            await fs.access(envPath);
+            envExists = true;
+        } catch  {
+        // .env doesn't exist
+        }
+        if (!envExists) {
+            // Create .env from .env.example
+            const sanitized = sanitizeEnv(envExampleContents, payloadSecret);
+            await fs.writeFile(envPath, sanitized, 'utf-8');
+        } else {
+            // Update existing .env if it doesn't have PAYLOAD_SECRET
+            const existingContents = await fs.readFile(envPath, 'utf-8');
+            if (!existingContents.includes('PAYLOAD_SECRET=') && !existingContents.includes('PAYLOAD_SECRET_KEY=')) {
+                const sanitized = sanitizeEnv(existingContents, payloadSecret);
+                await fs.writeFile(envPath, sanitized, 'utf-8');
+            }
+        }
+        return payloadSecret;
+    } catch (error) {
+        throw new Error(`Failed to manage environment files: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+
+//# sourceMappingURL=env-management.js.map

package/dist/utils/env-management.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/env-management.ts"],"sourcesContent":["import { randomBytes } from 'crypto'\nimport fs from 'fs/promises'\nimport path from 'path'\n\n/**\n * Generate a cryptographically secure secret for PAYLOAD_SECRET\n *\n * @returns 24-character hexadecimal string\n */\nexport function generateSecret(): string {\n  return randomBytes(32).toString('hex').slice(0, 24)\n}\n\n/**\n * Sanitize and process environment file contents\n *\n * @param contents - Raw .env file contents\n * @param payloadSecret - Secret to use for PAYLOAD_SECRET\n * @returns Processed .env contents\n */\nfunction sanitizeEnv(contents: string, payloadSecret: string): string {\n  const lines = contents.split('\\n')\n  const seenKeys = new Set<string>()\n  const processedLines: string[] = []\n\n  for (const line of lines) {\n    // Skip empty lines and comments\n    if (!line.trim() || line.trim().startsWith('#')) {\n      processedLines.push(line)\n      continue\n    }\n\n    // Skip lines without =\n    if (!line.includes('=')) {\n      processedLines.push(line)\n      continue\n    }\n\n    const [key] = line.split('=')\n    const trimmedKey = key.trim()\n\n    // Skip duplicate keys\n    if (seenKeys.has(trimmedKey)) {\n      continue\n    }\n    seenKeys.add(trimmedKey)\n\n    // Replace PAYLOAD_SECRET with actual value\n    if (trimmedKey === 'PAYLOAD_SECRET' || trimmedKey === 'PAYLOAD_SECRET_KEY') {\n      processedLines.push(`PAYLOAD_SECRET=${payloadSecret}`)\n    } else {\n      processedLines.push(line)\n    }\n  }\n\n  // Add PAYLOAD_SECRET if not present\n  if (!seenKeys.has('PAYLOAD_SECRET') && !seenKeys.has('PAYLOAD_SECRET_KEY')) {\n    processedLines.push(`PAYLOAD_SECRET=${payloadSecret}`)\n  }\n\n  return processedLines.join('\\n')\n}\n\n/**\n * Manage environment files for a new project\n *\n * Creates .env from .env.example (if exists) and populates PAYLOAD_SECRET\n *\n * @param projectPath - Path to project directory\n * @returns The generated payload secret\n */\nexport async function manageEnvFiles(projectPath: string): Promise<string> {\n  const payloadSecret = generateSecret()\n  const envExamplePath = path.join(projectPath, '.env.example')\n  const envPath = path.join(projectPath, '.env')\n\n  try {\n    // Check if .env.example exists\n    let envExampleContents = ''\n    try {\n      envExampleContents = await fs.readFile(envExamplePath, 'utf-8')\n    } catch {\n      // No .env.example, create minimal .env\n      envExampleContents = ''\n    }\n\n    // Check if .env already exists\n    let envExists = false\n    try {\n      await fs.access(envPath)\n      envExists = true\n    } catch {\n      // .env doesn't exist\n    }\n\n    if (!envExists) {\n      // Create .env from .env.example\n      const sanitized = sanitizeEnv(envExampleContents, payloadSecret)\n      await fs.writeFile(envPath, sanitized, 'utf-8')\n    } else {\n      // Update existing .env if it doesn't have PAYLOAD_SECRET\n      const existingContents = await fs.readFile(envPath, 'utf-8')\n      if (\n        !existingContents.includes('PAYLOAD_SECRET=') &&\n        !existingContents.includes('PAYLOAD_SECRET_KEY=')\n      ) {\n        const sanitized = sanitizeEnv(existingContents, payloadSecret)\n        await fs.writeFile(envPath, sanitized, 'utf-8')\n      }\n    }\n\n    return payloadSecret\n  } catch (error) {\n    throw new Error(\n      `Failed to manage environment files: ${error instanceof Error ? error.message : 'Unknown error'}`,\n    )\n  }\n}\n"],"names":["randomBytes","fs","path","generateSecret","toString","slice","sanitizeEnv","contents","payloadSecret","lines","split","seenKeys","Set","processedLines","line","trim","startsWith","push","includes","key","trimmedKey","has","add","join","manageEnvFiles","projectPath","envExamplePath","envPath","envExampleContents","readFile","envExists","access","sanitized","writeFile","existingContents","error","Error","message"],"mappings":"AAAA,SAASA,WAAW,QAAQ,SAAQ;AACpC,OAAOC,QAAQ,cAAa;AAC5B,OAAOC,UAAU,OAAM;AAEvB;;;;CAIC,GACD,OAAO,SAASC;IACd,OAAOH,YAAY,IAAII,QAAQ,CAAC,OAAOC,KAAK,CAAC,GAAG;AAClD;AAEA;;;;;;CAMC,GACD,SAASC,YAAYC,QAAgB,EAAEC,aAAqB;IAC1D,MAAMC,QAAQF,SAASG,KAAK,CAAC;IAC7B,MAAMC,WAAW,IAAIC;IACrB,MAAMC,iBAA2B,EAAE;IAEnC,KAAK,MAAMC,QAAQL,MAAO;QACxB,gCAAgC;QAChC,IAAI,CAACK,KAAKC,IAAI,MAAMD,KAAKC,IAAI,GAAGC,UAAU,CAAC,MAAM;YAC/CH,eAAeI,IAAI,CAACH;YACpB;QACF;QAEA,uBAAuB;QACvB,IAAI,CAACA,KAAKI,QAAQ,CAAC,MAAM;YACvBL,eAAeI,IAAI,CAACH;YACpB;QACF;QAEA,MAAM,CAACK,IAAI,GAAGL,KAAKJ,KAAK,CAAC;QACzB,MAAMU,aAAaD,IAAIJ,IAAI;QAE3B,sBAAsB;QACtB,IAAIJ,SAASU,GAAG,CAACD,aAAa;YAC5B;QACF;QACAT,SAASW,GAAG,CAACF;QAEb,2CAA2C;QAC3C,IAAIA,eAAe,oBAAoBA,eAAe,sBAAsB;YAC1EP,eAAeI,IAAI,CAAC,CAAC,eAAe,EAAET,eAAe;QACvD,OAAO;YACLK,eAAeI,IAAI,CAACH;QACtB;IACF;IAEA,oCAAoC;IACpC,IAAI,CAACH,SAASU,GAAG,CAAC,qBAAqB,CAACV,SAASU,GAAG,CAAC,uBAAuB;QAC1ER,eAAeI,IAAI,CAAC,CAAC,eAAe,EAAET,eAAe;IACvD;IAEA,OAAOK,eAAeU,IAAI,CAAC;AAC7B;AAEA;;;;;;;CAOC,GACD,OAAO,eAAeC,eAAeC,WAAmB;IACtD,MAAMjB,gBAAgBL;IACtB,MAAMuB,iBAAiBxB,KAAKqB,IAAI,CAACE,aAAa;IAC9C,MAAME,UAAUzB,KAAKqB,IAAI,CAACE,aAAa;IAEvC,IAAI;QACF,+BAA+B;QAC/B,IAAIG,qBAAqB;QACzB,IAAI;YACFA,qBAAqB,MAAM3B,GAAG4B,QAAQ,CAACH,gBAAgB;QACzD,EAAE,OAAM;YACN,uCAAuC;YACvCE,qBAAqB;QACvB;QAEA,+BAA+B;QAC/B,IAAIE,YAAY;QAChB,IAAI;YACF,MAAM7B,GAAG8B,MAAM,CAACJ;YAChBG,YAAY;QACd,EAAE,OAAM;QACN,qBAAqB;QACvB;QAEA,IAAI,CAACA,WAAW;YACd,gCAAgC;YAChC,MAAME,YAAY1B,YAAYsB,oBAAoBpB;YAClD,MAAMP,GAAGgC,SAAS,CAACN,SAASK,WAAW;QACzC,OAAO;YACL,yDAAyD;YACzD,MAAME,mBAAmB,MAAMjC,GAAG4B,QAAQ,CAACF,SAAS;YACpD,IACE,CAACO,iBAAiBhB,QAAQ,CAAC,sBAC3B,CAACgB,iBAAiBhB,QAAQ,CAAC,wBAC3B;gBACA,MAAMc,YAAY1B,YAAY4B,kBAAkB1B;gBAChD,MAAMP,GAAGgC,SAAS,CAACN,SAASK,WAAW;YACzC;QACF;QAEA,OAAOxB;IACT,EAAE,OAAO2B,OAAO;QACd,MAAM,IAAIC,MACR,CAAC,oCAAoC,EAAED,iBAAiBC,QAAQD,MAAME,OAAO,GAAG,iBAAiB;IAErG;AACF"}

package/dist/utils/env-management.spec.d.ts

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

package/dist/utils/env-management.spec.d.ts.map

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