@codeyam/codeyam-cli 0.1.0-staging.103bd05 → 0.1.0-staging.121e983

package/codeyam-cli/src/utils/__tests__/envFile.test.js

@@ -0,0 +1,125 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { readEnvVar, writeEnvVar, parseGitHubRepo } from "../envFile.js";
+let tmpDir;
+beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'envfile-test-'));
+});
+afterEach(() => {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+});
+// ── readEnvVar ────────────────────────────────────────────────────────
+describe('readEnvVar', () => {
+    it('reads a simple key=value from .env.local', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), 'VERCEL_TOKEN=tok_abc123\n');
+        expect(readEnvVar(tmpDir, 'VERCEL_TOKEN')).toBe('tok_abc123');
+    });
+    it('reads from .env when .env.local does not exist', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env'), 'MY_KEY=from_env\n');
+        expect(readEnvVar(tmpDir, 'MY_KEY')).toBe('from_env');
+    });
+    it('prefers .env.local over .env', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), 'KEY=local\n');
+        fs.writeFileSync(path.join(tmpDir, '.env'), 'KEY=base\n');
+        expect(readEnvVar(tmpDir, 'KEY')).toBe('local');
+    });
+    it('strips double quotes from values', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), 'KEY="quoted_val"\n');
+        expect(readEnvVar(tmpDir, 'KEY')).toBe('quoted_val');
+    });
+    it('strips single quotes from values', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), "KEY='single'\n");
+        expect(readEnvVar(tmpDir, 'KEY')).toBe('single');
+    });
+    it('skips comments', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), '# This is a comment\nKEY=val\n');
+        expect(readEnvVar(tmpDir, 'KEY')).toBe('val');
+    });
+    it('skips blank lines', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), '\n\nKEY=val\n');
+        expect(readEnvVar(tmpDir, 'KEY')).toBe('val');
+    });
+    it('returns null when key is not found', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), 'OTHER=val\n');
+        expect(readEnvVar(tmpDir, 'MISSING')).toBeNull();
+    });
+    it('returns null when no env files exist', () => {
+        expect(readEnvVar(tmpDir, 'KEY')).toBeNull();
+    });
+    it('returns null for empty values', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), 'KEY=\n');
+        expect(readEnvVar(tmpDir, 'KEY')).toBeNull();
+    });
+    it('handles values with equals signs', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), 'DATABASE_URL=postgres://user:pass@host/db?ssl=true\n');
+        expect(readEnvVar(tmpDir, 'DATABASE_URL')).toBe('postgres://user:pass@host/db?ssl=true');
+    });
+    it('reads from .env.development.local', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.development.local'), 'KEY=dev_local\n');
+        expect(readEnvVar(tmpDir, 'KEY')).toBe('dev_local');
+    });
+});
+// ── writeEnvVar ───────────────────────────────────────────────────────
+describe('writeEnvVar', () => {
+    it('creates .env.local if it does not exist', () => {
+        writeEnvVar(tmpDir, 'NEW_KEY', 'new_value');
+        const content = fs.readFileSync(path.join(tmpDir, '.env.local'), 'utf-8');
+        expect(content).toContain('NEW_KEY=new_value');
+    });
+    it('appends to existing .env.local', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), 'EXISTING=val\n');
+        writeEnvVar(tmpDir, 'NEW_KEY', 'new_val');
+        const content = fs.readFileSync(path.join(tmpDir, '.env.local'), 'utf-8');
+        expect(content).toContain('EXISTING=val');
+        expect(content).toContain('NEW_KEY=new_val');
+    });
+    it('updates existing key in .env.local', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), 'KEY=old_val\n');
+        writeEnvVar(tmpDir, 'KEY', 'new_val');
+        const content = fs.readFileSync(path.join(tmpDir, '.env.local'), 'utf-8');
+        expect(content).toContain('KEY=new_val');
+        expect(content).not.toContain('old_val');
+    });
+    it('does not modify comments when updating', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), '# Comment\nKEY=old\n');
+        writeEnvVar(tmpDir, 'KEY', 'new');
+        const content = fs.readFileSync(path.join(tmpDir, '.env.local'), 'utf-8');
+        expect(content).toContain('# Comment');
+        expect(content).toContain('KEY=new');
+    });
+    it('roundtrips with readEnvVar', () => {
+        writeEnvVar(tmpDir, 'TOKEN', 'secret_123');
+        expect(readEnvVar(tmpDir, 'TOKEN')).toBe('secret_123');
+    });
+});
+// ── parseGitHubRepo ───────────────────────────────────────────────────
+describe('parseGitHubRepo', () => {
+    it('parses HTTPS URL', () => {
+        const result = parseGitHubRepo('https://github.com/codeyam-ai/codeyam.git');
+        expect(result).toEqual({ owner: 'codeyam-ai', repo: 'codeyam' });
+    });
+    it('parses HTTPS URL without .git', () => {
+        const result = parseGitHubRepo('https://github.com/jaredcosulich/testapp');
+        expect(result).toEqual({ owner: 'jaredcosulich', repo: 'testapp' });
+    });
+    it('parses SSH URL', () => {
+        const result = parseGitHubRepo('git@github.com:codeyam-ai/codeyam.git');
+        expect(result).toEqual({ owner: 'codeyam-ai', repo: 'codeyam' });
+    });
+    it('parses SSH URL without .git', () => {
+        const result = parseGitHubRepo('git@github.com:owner/repo');
+        expect(result).toEqual({ owner: 'owner', repo: 'repo' });
+    });
+    it('returns null for non-GitHub URLs', () => {
+        expect(parseGitHubRepo('https://gitlab.com/owner/repo.git')).toBeNull();
+    });
+    it('returns null for invalid URLs', () => {
+        expect(parseGitHubRepo('not-a-url')).toBeNull();
+    });
+    it('handles repos with hyphens and underscores', () => {
+        const result = parseGitHubRepo('https://github.com/my-org/my_project-name.git');
+        expect(result).toEqual({ owner: 'my-org', repo: 'my_project-name' });
+    });
+});
+//# sourceMappingURL=envFile.test.js.map

package/codeyam-cli/src/utils/__tests__/envFile.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envFile.test.js","sourceRoot":"","sources":["../../../../../src/utils/__tests__/envFile.test.ts"],"names":[],"mappings":"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"}

package/codeyam-cli/src/utils/__tests__/glossaryAdd.test.js

@@ -0,0 +1,177 @@
+import { validateGlossaryEntry, mergeGlossaryEntries } from "../glossaryAdd.js";
+describe('glossaryAdd', () => {
+    describe('validateGlossaryEntry', () => {
+        it('should accept a valid entry with all required fields', () => {
+            const result = validateGlossaryEntry({
+                name: 'DrinkCard',
+                filePath: 'app/components/DrinkCard.tsx',
+                description: 'Displays a single drink item',
+            });
+            expect(result.valid).toBe(true);
+            expect(result.error).toBeUndefined();
+        });
+        it('should reject missing name', () => {
+            const result = validateGlossaryEntry({
+                filePath: 'app/components/DrinkCard.tsx',
+                description: 'Displays a single drink item',
+            });
+            expect(result.valid).toBe(false);
+            expect(result.error).toContain('name');
+        });
+        it('should reject missing filePath', () => {
+            const result = validateGlossaryEntry({
+                name: 'DrinkCard',
+                description: 'Displays a single drink item',
+            });
+            expect(result.valid).toBe(false);
+            expect(result.error).toContain('filePath');
+        });
+        it('should reject missing description', () => {
+            const result = validateGlossaryEntry({
+                name: 'DrinkCard',
+                filePath: 'app/components/DrinkCard.tsx',
+            });
+            expect(result.valid).toBe(false);
+            expect(result.error).toContain('description');
+        });
+        it('should reject non-object input', () => {
+            expect(validateGlossaryEntry('string').valid).toBe(false);
+            expect(validateGlossaryEntry(null).valid).toBe(false);
+            expect(validateGlossaryEntry(42).valid).toBe(false);
+        });
+    });
+    describe('mergeGlossaryEntries', () => {
+        it('should append new entry to empty array', () => {
+            const result = mergeGlossaryEntries([], [
+                {
+                    name: 'DrinkCard',
+                    filePath: 'app/components/DrinkCard.tsx',
+                    description: 'A drink card',
+                },
+            ]);
+            expect(result.entries).toHaveLength(1);
+            expect(result.entries[0].name).toBe('DrinkCard');
+            expect(result.added).toBe(1);
+            expect(result.updated).toBe(0);
+            expect(result.errors).toHaveLength(0);
+        });
+        it('should append new entry to existing array', () => {
+            const existing = [
+                {
+                    name: 'Header',
+                    filePath: 'app/components/Header.tsx',
+                    description: 'Page header',
+                },
+            ];
+            const result = mergeGlossaryEntries(existing, [
+                {
+                    name: 'DrinkCard',
+                    filePath: 'app/components/DrinkCard.tsx',
+                    description: 'A drink card',
+                },
+            ]);
+            expect(result.entries).toHaveLength(2);
+            expect(result.added).toBe(1);
+            expect(result.updated).toBe(0);
+        });
+        it('should update existing entry when name + filePath match', () => {
+            const existing = [
+                {
+                    name: 'DrinkCard',
+                    filePath: 'app/components/DrinkCard.tsx',
+                    description: 'Old description',
+                },
+            ];
+            const result = mergeGlossaryEntries(existing, [
+                {
+                    name: 'DrinkCard',
+                    filePath: 'app/components/DrinkCard.tsx',
+                    description: 'New description',
+                },
+            ]);
+            expect(result.entries).toHaveLength(1);
+            expect(result.entries[0].description).toBe('New description');
+            expect(result.added).toBe(0);
+            expect(result.updated).toBe(1);
+        });
+        it('should handle mix of new and updated entries', () => {
+            const existing = [
+                {
+                    name: 'Header',
+                    filePath: 'app/components/Header.tsx',
+                    description: 'Page header',
+                },
+                {
+                    name: 'DrinkCard',
+                    filePath: 'app/components/DrinkCard.tsx',
+                    description: 'Old',
+                },
+            ];
+            const result = mergeGlossaryEntries(existing, [
+                {
+                    name: 'DrinkCard',
+                    filePath: 'app/components/DrinkCard.tsx',
+                    description: 'Updated',
+                },
+                {
+                    name: 'Footer',
+                    filePath: 'app/components/Footer.tsx',
+                    description: 'Page footer',
+                },
+            ]);
+            expect(result.entries).toHaveLength(3);
+            expect(result.added).toBe(1);
+            expect(result.updated).toBe(1);
+            // Updated entry should preserve its position
+            expect(result.entries[1].name).toBe('DrinkCard');
+            expect(result.entries[1].description).toBe('Updated');
+        });
+        it('should return correct added/updated counts', () => {
+            const existing = [
+                { name: 'A', filePath: 'a.ts', description: 'a' },
+                { name: 'B', filePath: 'b.ts', description: 'b' },
+            ];
+            const result = mergeGlossaryEntries(existing, [
+                { name: 'A', filePath: 'a.ts', description: 'updated a' },
+                { name: 'C', filePath: 'c.ts', description: 'new c' },
+                { name: 'D', filePath: 'd.ts', description: 'new d' },
+            ]);
+            expect(result.added).toBe(2);
+            expect(result.updated).toBe(1);
+            expect(result.entries).toHaveLength(4);
+        });
+        it('should preserve extra fields on existing entries not in incoming', () => {
+            const existing = [
+                {
+                    name: 'DrinkCard',
+                    filePath: 'app/components/DrinkCard.tsx',
+                    description: 'Old',
+                    returnType: 'JSX.Element',
+                    testFile: 'tests/DrinkCard.test.ts',
+                },
+            ];
+            const result = mergeGlossaryEntries(existing, [
+                {
+                    name: 'DrinkCard',
+                    filePath: 'app/components/DrinkCard.tsx',
+                    description: 'New',
+                },
+            ]);
+            expect(result.entries[0].returnType).toBe('JSX.Element');
+            expect(result.entries[0].testFile).toBe('tests/DrinkCard.test.ts');
+            expect(result.entries[0].description).toBe('New');
+        });
+        it('should report errors for invalid entries', () => {
+            const result = mergeGlossaryEntries([], [
+                { name: 'Good', filePath: 'a.ts', description: 'valid' },
+                { filePath: 'b.ts', description: 'missing name' },
+                { name: 'Also Good', filePath: 'c.ts', description: 'valid' },
+            ]);
+            expect(result.entries).toHaveLength(2);
+            expect(result.added).toBe(2);
+            expect(result.errors).toHaveLength(1);
+            expect(result.errors[0].index).toBe(1);
+        });
+    });
+});
+//# sourceMappingURL=glossaryAdd.test.js.map

package/codeyam-cli/src/utils/__tests__/glossaryAdd.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossaryAdd.test.js","sourceRoot":"","sources":["../../../../../src/utils/__tests__/glossaryAdd.test.ts"],"names":[],"mappings":"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"}