@codeyam/codeyam-cli 0.1.0-staging.76566f9 → 0.1.0-staging.78c1cad

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

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

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

@@ -0,0 +1,302 @@
+import { convertTypeInfoToDataForMocks, validateManualEntityInput, readAnalysisFailures, writeAnalysisFailures, clearFailureForPath, } from "../manualEntityAnalysis.js";
+// ─── convertTypeInfoToDataForMocks ────────────────────────────────────
+describe('convertTypeInfoToDataForMocks', () => {
+    it('converts simple component props to dot-notation', () => {
+        const typeInfo = {
+            props: {
+                title: 'string',
+                count: 'number',
+                isActive: 'boolean',
+            },
+        };
+        const result = convertTypeInfoToDataForMocks(typeInfo);
+        expect(result).toEqual({
+            'props.title': 'string',
+            'props.count': 'number',
+            'props.isActive': 'boolean',
+        });
+    });
+    it('converts nested props to dot-notation', () => {
+        const typeInfo = {
+            props: {
+                user: {
+                    name: 'string',
+                    avatar: 'string',
+                },
+            },
+        };
+        const result = convertTypeInfoToDataForMocks(typeInfo);
+        expect(result).toEqual({
+            'props.user': 'object',
+            'props.user.name': 'string',
+            'props.user.avatar': 'string',
+        });
+    });
+    it('converts hook return types to dot-notation with call syntax', () => {
+        const typeInfo = {
+            hooks: {
+                useAuth: {
+                    isLoggedIn: 'boolean',
+                    user: { id: 'string', name: 'string' },
+                },
+            },
+        };
+        const result = convertTypeInfoToDataForMocks(typeInfo);
+        expect(result).toEqual({
+            'useAuth()': 'object',
+            'useAuth().isLoggedIn': 'boolean',
+            'useAuth().user': 'object',
+            'useAuth().user.id': 'string',
+            'useAuth().user.name': 'string',
+        });
+    });
+    it('converts function params to dot-notation', () => {
+        const typeInfo = {
+            params: {
+                sortBy: 'string',
+                limit: 'number',
+            },
+        };
+        const result = convertTypeInfoToDataForMocks(typeInfo);
+        expect(result).toEqual({
+            'params.sortBy': 'string',
+            'params.limit': 'number',
+        });
+    });
+    it('converts function returns to dot-notation', () => {
+        const typeInfo = {
+            returns: {
+                id: 'string',
+                name: 'string',
+                rank: 'number',
+            },
+        };
+        const result = convertTypeInfoToDataForMocks(typeInfo);
+        expect(result).toEqual({
+            returns: 'object',
+            'returns.id': 'string',
+            'returns.name': 'string',
+            'returns.rank': 'number',
+        });
+    });
+    it('handles arrays via _type marker', () => {
+        const typeInfo = {
+            returns: {
+                _type: 'array',
+                id: 'string',
+                name: 'string',
+            },
+        };
+        const result = convertTypeInfoToDataForMocks(typeInfo);
+        expect(result).toEqual({
+            'returns[]': 'array',
+            'returns[].id': 'string',
+            'returns[].name': 'string',
+        });
+    });
+    it('returns empty object for empty typeInfo', () => {
+        expect(convertTypeInfoToDataForMocks({})).toEqual({});
+        expect(convertTypeInfoToDataForMocks(undefined)).toEqual({});
+    });
+    it('handles mixed props and hooks together', () => {
+        const typeInfo = {
+            props: { title: 'string' },
+            hooks: { useRouter: { pathname: 'string' } },
+        };
+        const result = convertTypeInfoToDataForMocks(typeInfo);
+        expect(result).toEqual({
+            'props.title': 'string',
+            'useRouter()': 'object',
+            'useRouter().pathname': 'string',
+        });
+    });
+});
+// ─── validateManualEntityInput ────────────────────────────────────────
+describe('validateManualEntityInput', () => {
+    const glossaryEntries = [
+        { name: 'Icon', filePath: 'src/components/Icon.tsx' },
+        { name: 'useAuth', filePath: 'src/hooks/useAuth.ts' },
+        { name: 'Button', filePath: 'src/components/Button.tsx' },
+    ];
+    it('returns no errors for valid input', () => {
+        const input = {
+            name: 'Header',
+            filePath: 'src/components/Header.tsx',
+            entityType: 'visual',
+            importedExports: [{ name: 'Icon', filePath: 'src/components/Icon.tsx' }],
+        };
+        const errors = validateManualEntityInput(input, glossaryEntries, {
+            fileExists: () => true,
+        });
+        expect(errors).toEqual([]);
+    });
+    it('rejects missing name', () => {
+        const input = {
+            filePath: 'src/components/Header.tsx',
+            entityType: 'visual',
+        };
+        const errors = validateManualEntityInput(input, glossaryEntries, {
+            fileExists: () => true,
+        });
+        expect(errors).toContain('name is required');
+    });
+    it('rejects missing filePath', () => {
+        const input = {
+            name: 'Header',
+            entityType: 'visual',
+        };
+        const errors = validateManualEntityInput(input, glossaryEntries, {
+            fileExists: () => true,
+        });
+        expect(errors).toContain('filePath is required');
+    });
+    it('rejects nonexistent file', () => {
+        const input = {
+            name: 'Header',
+            filePath: 'src/components/Header.tsx',
+            entityType: 'visual',
+        };
+        const errors = validateManualEntityInput(input, glossaryEntries, {
+            fileExists: () => false,
+        });
+        expect(errors).toContain('File does not exist: src/components/Header.tsx');
+    });
+    it('rejects invalid entityType', () => {
+        const input = {
+            name: 'Header',
+            filePath: 'src/components/Header.tsx',
+            entityType: 'invalid',
+        };
+        const errors = validateManualEntityInput(input, glossaryEntries, {
+            fileExists: () => true,
+        });
+        expect(errors.some((e) => e.includes('entityType'))).toBe(true);
+    });
+    it('rejects importedExports referencing unknown glossary entities', () => {
+        const input = {
+            name: 'Header',
+            filePath: 'src/components/Header.tsx',
+            entityType: 'visual',
+            importedExports: [
+                { name: 'NonExistent', filePath: 'src/components/NonExistent.tsx' },
+            ],
+        };
+        const errors = validateManualEntityInput(input, glossaryEntries, {
+            fileExists: () => true,
+        });
+        expect(errors.some((e) => e.includes('NonExistent'))).toBe(true);
+    });
+    it('allows empty importedExports', () => {
+        const input = {
+            name: 'Header',
+            filePath: 'src/components/Header.tsx',
+            entityType: 'visual',
+            importedExports: [],
+        };
+        const errors = validateManualEntityInput(input, glossaryEntries, {
+            fileExists: () => true,
+        });
+        expect(errors).toEqual([]);
+    });
+    it('allows omitted importedExports', () => {
+        const input = {
+            name: 'Header',
+            filePath: 'src/components/Header.tsx',
+            entityType: 'visual',
+        };
+        const errors = validateManualEntityInput(input, glossaryEntries, {
+            fileExists: () => true,
+        });
+        expect(errors).toEqual([]);
+    });
+});
+// ─── Failure tracker ──────────────────────────────────────────────────
+describe('failure tracker', () => {
+    describe('readAnalysisFailures', () => {
+        it('returns empty object when file does not exist', () => {
+            const result = readAnalysisFailures('/nonexistent/path');
+            expect(result).toEqual({});
+        });
+        it('returns parsed data from valid JSON file', () => {
+            const mockData = {
+                'src/components/Header.tsx': {
+                    entityName: 'Header',
+                    error: 'Parse error',
+                    failedAt: '2026-03-23T10:00:00Z',
+                },
+            };
+            const result = readAnalysisFailures('/test/path', {
+                readFileSync: () => JSON.stringify(mockData),
+                existsSync: () => true,
+            });
+            expect(result).toEqual(mockData);
+        });
+        it('returns empty object when file has invalid JSON', () => {
+            const result = readAnalysisFailures('/test/path', {
+                readFileSync: () => 'not valid json',
+                existsSync: () => true,
+            });
+            expect(result).toEqual({});
+        });
+    });
+    describe('writeAnalysisFailures', () => {
+        it('writes failures to the correct path', () => {
+            const written = [];
+            const failures = {
+                'src/components/Header.tsx': {
+                    entityName: 'Header',
+                    error: 'Parse error',
+                    failedAt: '2026-03-23T10:00:00Z',
+                },
+            };
+            writeAnalysisFailures('/project/root', failures, {
+                writeFileSync: (p, c) => written.push({ path: p, content: c }),
+                mkdirSync: () => { },
+            });
+            expect(written).toHaveLength(1);
+            expect(written[0].path).toContain('analysis-failures.json');
+            expect(JSON.parse(written[0].content)).toEqual(failures);
+        });
+        it('removes the file when failures is empty', () => {
+            const removed = [];
+            writeAnalysisFailures('/project/root', {}, {
+                unlinkSync: (p) => removed.push(p),
+                existsSync: () => true,
+            });
+            expect(removed).toHaveLength(1);
+            expect(removed[0]).toContain('analysis-failures.json');
+        });
+    });
+    describe('clearFailureForPath', () => {
+        it('removes the specified path from failures', () => {
+            const failures = {
+                'src/components/Header.tsx': {
+                    entityName: 'Header',
+                    error: 'Parse error',
+                    failedAt: '2026-03-23T10:00:00Z',
+                },
+                'src/components/Footer.tsx': {
+                    entityName: 'Footer',
+                    error: 'Parse error',
+                    failedAt: '2026-03-23T10:00:00Z',
+                },
+            };
+            const result = clearFailureForPath(failures, 'src/components/Header.tsx');
+            expect(result).toEqual({
+                'src/components/Footer.tsx': failures['src/components/Footer.tsx'],
+            });
+        });
+        it('returns unchanged object when path not found', () => {
+            const failures = {
+                'src/components/Header.tsx': {
+                    entityName: 'Header',
+                    error: 'Parse error',
+                    failedAt: '2026-03-23T10:00:00Z',
+                },
+            };
+            const result = clearFailureForPath(failures, 'src/components/Other.tsx');
+            expect(result).toEqual(failures);
+        });
+    });
+});
+//# sourceMappingURL=manualEntityAnalysis.test.js.map

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

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

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

@@ -0,0 +1,185 @@
+/**
+ * Tests for npm version check utility.
+ *
+ * Tests the version comparison logic and npm registry check used to show
+ * an upgrade banner when a newer CLI version is published.
+ *
+ * Note: We test the logic functions directly rather than importing the module
+ * (which uses import.meta.url via versionInfo.ts).
+ */
+// --- isNewerVersion tests (pure logic, no imports needed) ---
+/**
+ * Compares two semver-style version strings.
+ * Returns true if `latest` is strictly newer than `current`.
+ */
+function isNewerVersion(latest, current) {
+    const latestParts = latest.split('.').map(Number);
+    const currentParts = current.split('.').map(Number);
+    for (let i = 0; i < Math.max(latestParts.length, currentParts.length); i++) {
+        const l = latestParts[i] ?? 0;
+        const c = currentParts[i] ?? 0;
+        if (isNaN(l) || isNaN(c))
+            return false;
+        if (l > c)
+            return true;
+        if (l < c)
+            return false;
+    }
+    return false;
+}
+describe('isNewerVersion', () => {
+    it('returns true when latest is newer (patch)', () => {
+        expect(isNewerVersion('0.1.643', '0.1.642')).toBe(true);
+    });
+    it('returns true when latest is newer (minor)', () => {
+        expect(isNewerVersion('0.2.0', '0.1.642')).toBe(true);
+    });
+    it('returns true when latest is newer (major)', () => {
+        expect(isNewerVersion('1.0.0', '0.1.642')).toBe(true);
+    });
+    it('returns false when versions are equal', () => {
+        expect(isNewerVersion('0.1.642', '0.1.642')).toBe(false);
+    });
+    it('returns false when latest is older', () => {
+        expect(isNewerVersion('0.1.641', '0.1.642')).toBe(false);
+    });
+    it('returns false when latest is older (minor)', () => {
+        expect(isNewerVersion('0.0.999', '0.1.0')).toBe(false);
+    });
+    it('handles different segment counts', () => {
+        expect(isNewerVersion('1.0', '0.9.9')).toBe(true);
+        expect(isNewerVersion('0.9.9', '1.0')).toBe(false);
+    });
+    it('returns false for malformed input', () => {
+        expect(isNewerVersion('abc', '0.1.0')).toBe(false);
+        expect(isNewerVersion('0.1.0', 'abc')).toBe(false);
+        expect(isNewerVersion('', '')).toBe(false);
+    });
+    it('returns false when current is "unknown"', () => {
+        expect(isNewerVersion('0.1.643', 'unknown')).toBe(false);
+    });
+    it('returns false when latest is "unknown"', () => {
+        expect(isNewerVersion('unknown', '0.1.642')).toBe(false);
+    });
+    it('returns false when current is a dev build string', () => {
+        expect(isNewerVersion('0.1.4', 'dev (build 662)')).toBe(false);
+    });
+    it('returns false when current is a staging prerelease', () => {
+        expect(isNewerVersion('0.1.4', '0.1.0-staging.1a2737b')).toBe(false);
+    });
+});
+// --- checkForNpmUpdate tests (mocked fetch) ---
+describe('checkForNpmUpdate', () => {
+    const originalFetch = globalThis.fetch;
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+    });
+    /**
+     * Minimal reimplementation of checkForNpmUpdate for testing.
+     * The real module can't be imported due to import.meta.url in versionInfo.ts,
+     * so we replicate the logic here and verify the behavior.
+     */
+    async function checkForNpmUpdate(currentVersion) {
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 5000);
+            const response = await fetch('https://registry.npmjs.org/@codeyam/codeyam-cli/latest', { signal: controller.signal });
+            clearTimeout(timeout);
+            if (!response.ok) {
+                return { updateAvailable: false, latestVersion: null, currentVersion };
+            }
+            const data = (await response.json());
+            const latestVersion = data.version;
+            if (!latestVersion) {
+                return { updateAvailable: false, latestVersion: null, currentVersion };
+            }
+            return {
+                updateAvailable: isNewerVersion(latestVersion, currentVersion),
+                latestVersion,
+                currentVersion,
+            };
+        }
+        catch {
+            return { updateAvailable: false, latestVersion: null, currentVersion };
+        }
+    }
+    it('returns updateAvailable: true when npm has a newer version', async () => {
+        globalThis.fetch = jest.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ version: '0.1.2' }),
+        });
+        const result = await checkForNpmUpdate('0.1.1');
+        expect(result).toEqual({
+            updateAvailable: true,
+            latestVersion: '0.1.2',
+            currentVersion: '0.1.1',
+        });
+    });
+    it('returns updateAvailable: false when versions match', async () => {
+        globalThis.fetch = jest.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ version: '0.1.1' }),
+        });
+        const result = await checkForNpmUpdate('0.1.1');
+        expect(result).toEqual({
+            updateAvailable: false,
+            latestVersion: '0.1.1',
+            currentVersion: '0.1.1',
+        });
+    });
+    it('returns updateAvailable: false when local is newer', async () => {
+        globalThis.fetch = jest.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ version: '0.1.0' }),
+        });
+        const result = await checkForNpmUpdate('0.1.1');
+        expect(result).toEqual({
+            updateAvailable: false,
+            latestVersion: '0.1.0',
+            currentVersion: '0.1.1',
+        });
+    });
+    it('returns updateAvailable: false on network error', async () => {
+        globalThis.fetch = jest.fn().mockRejectedValue(new Error('Network error'));
+        const result = await checkForNpmUpdate('0.1.1');
+        expect(result).toEqual({
+            updateAvailable: false,
+            latestVersion: null,
+            currentVersion: '0.1.1',
+        });
+    });
+    it('returns updateAvailable: false on non-ok response', async () => {
+        globalThis.fetch = jest.fn().mockResolvedValue({
+            ok: false,
+            status: 404,
+        });
+        const result = await checkForNpmUpdate('0.1.1');
+        expect(result).toEqual({
+            updateAvailable: false,
+            latestVersion: null,
+            currentVersion: '0.1.1',
+        });
+    });
+    it('returns updateAvailable: false when response has no version field', async () => {
+        globalThis.fetch = jest.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ name: '@codeyam/codeyam-cli' }),
+        });
+        const result = await checkForNpmUpdate('0.1.1');
+        expect(result).toEqual({
+            updateAvailable: false,
+            latestVersion: null,
+            currentVersion: '0.1.1',
+        });
+    });
+    it('handles fetch abort (timeout) gracefully', async () => {
+        globalThis.fetch = jest.fn().mockRejectedValue(new DOMException('Aborted'));
+        const result = await checkForNpmUpdate('0.1.1');
+        expect(result).toEqual({
+            updateAvailable: false,
+            latestVersion: null,
+            currentVersion: '0.1.1',
+        });
+    });
+});
+//# sourceMappingURL=npmVersionCheck.test.js.map

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

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

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

@@ -0,0 +1,129 @@
+import { parseRegisterArg } from "../parseRegisterArg.js";
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+describe('parseRegisterArg', () => {
+    let tempDir;
+    beforeEach(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'parse-register-test-'));
+    });
+    afterEach(() => {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    });
+    describe('inline JSON', () => {
+        it('should parse inline JSON string', () => {
+            const result = parseRegisterArg('{"name":"DrinkCard - Default","componentName":"DrinkCard"}');
+            expect(result.error).toBeUndefined();
+            expect(result.body).toEqual({
+                name: 'DrinkCard - Default',
+                componentName: 'DrinkCard',
+            });
+        });
+        it('should return error for invalid JSON', () => {
+            const result = parseRegisterArg('{not valid json}');
+            expect(result.error).toBe('Invalid JSON');
+            expect(result.body).toBeUndefined();
+        });
+        it('should return error for empty string', () => {
+            const result = parseRegisterArg('');
+            expect(result.error).toBe('JSON argument required');
+        });
+    });
+    describe('@file prefix', () => {
+        it('should read JSON from file when prefixed with @', () => {
+            const scenarioData = {
+                name: 'Full Catalog',
+                type: 'application',
+                url: '/',
+                seed: {
+                    drinks: [
+                        { id: 1, name: 'Latte', price: 4.5 },
+                        { id: 2, name: 'Espresso', price: 3.0 },
+                    ],
+                },
+            };
+            const filePath = path.join(tempDir, 'scenario.json');
+            fs.writeFileSync(filePath, JSON.stringify(scenarioData));
+            const result = parseRegisterArg(`@${filePath}`);
+            expect(result.error).toBeUndefined();
+            expect(result.body).toEqual(scenarioData);
+        });
+        it('should return error when file does not exist', () => {
+            const result = parseRegisterArg('@/tmp/nonexistent-scenario-file.json');
+            expect(result.error).toContain('File not found');
+        });
+        it('should return error when file contains invalid JSON', () => {
+            const filePath = path.join(tempDir, 'bad.json');
+            fs.writeFileSync(filePath, 'not json content');
+            const result = parseRegisterArg(`@${filePath}`);
+            expect(result.error).toBe('Invalid JSON');
+        });
+        it('should handle large scenario data from file', () => {
+            // Simulate a realistic large scenario with many seed rows
+            const largeSeedData = {
+                name: 'Large Catalog',
+                type: 'application',
+                url: '/',
+                seed: {
+                    drinks: Array.from({ length: 100 }, (_, i) => ({
+                        id: i + 1,
+                        name: `Drink ${i + 1}`,
+                        description: `A detailed description for drink number ${i + 1} that includes many words`,
+                        price: Math.round(Math.random() * 1000) / 100,
+                        category: ['coffee', 'tea', 'smoothie'][i % 3],
+                        ingredients: ['water', 'sugar', `ingredient-${i}`],
+                    })),
+                    categories: [
+                        { id: 1, name: 'Coffee', slug: 'coffee' },
+                        { id: 2, name: 'Tea', slug: 'tea' },
+                        { id: 3, name: 'Smoothie', slug: 'smoothie' },
+                    ],
+                },
+            };
+            const filePath = path.join(tempDir, 'large-scenario.json');
+            fs.writeFileSync(filePath, JSON.stringify(largeSeedData));
+            const result = parseRegisterArg(`@${filePath}`);
+            expect(result.error).toBeUndefined();
+            const body = result.body;
+            expect(body.name).toBe('Large Catalog');
+            expect(body.seed.drinks).toHaveLength(100);
+        });
+        it('should handle file path with spaces', () => {
+            const dirWithSpaces = path.join(tempDir, 'path with spaces');
+            fs.mkdirSync(dirWithSpaces, { recursive: true });
+            const filePath = path.join(dirWithSpaces, 'scenario.json');
+            fs.writeFileSync(filePath, '{"name":"test"}');
+            const result = parseRegisterArg(`@${filePath}`);
+            expect(result.error).toBeUndefined();
+            expect(result.body).toEqual({ name: 'test' });
+        });
+    });
+    describe('array input (batch registration)', () => {
+        it('should parse inline JSON array', () => {
+            const input = JSON.stringify([
+                { name: 'DrinkCard - Default', componentName: 'DrinkCard' },
+                { name: 'DrinkCard - Large', componentName: 'DrinkCard' },
+            ]);
+            const result = parseRegisterArg(input);
+            expect(result.error).toBeUndefined();
+            expect(Array.isArray(result.body)).toBe(true);
+            expect(result.body).toHaveLength(2);
+            expect(result.body[0].name).toBe('DrinkCard - Default');
+            expect(result.body[1].name).toBe('DrinkCard - Large');
+        });
+        it('should read JSON array from @file', () => {
+            const scenarios = [
+                { name: 'Scenario A', url: '/a' },
+                { name: 'Scenario B', url: '/b' },
+                { name: 'Scenario C', url: '/c' },
+            ];
+            const filePath = path.join(tempDir, 'batch.json');
+            fs.writeFileSync(filePath, JSON.stringify(scenarios));
+            const result = parseRegisterArg(`@${filePath}`);
+            expect(result.error).toBeUndefined();
+            expect(Array.isArray(result.body)).toBe(true);
+            expect(result.body).toHaveLength(3);
+        });
+    });
+});
+//# sourceMappingURL=parseRegisterArg.test.js.map