@geekmidas/cli 0.18.0 → 0.19.0

package/src/workspace/__tests__/client-generator.spec.ts

@@ -0,0 +1,357 @@
+import { existsSync, mkdirSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import {
+	clearSpecHashCache,
+	generateClientForFrontend,
+	getBackendDependencies,
+	getDependentFrontends,
+	getFirstRoute,
+	normalizeRoutes,
+	shouldRegenerateClient,
+} from '../client-generator.js';
+import type { NormalizedWorkspace } from '../types.js';
+
+describe('Client Generator', () => {
+	describe('normalizeRoutes', () => {
+		it('should return empty array for undefined', () => {
+			expect(normalizeRoutes(undefined)).toEqual([]);
+		});
+
+		it('should return array as-is', () => {
+			expect(normalizeRoutes(['./src/**/*.ts', './api/**/*.ts'])).toEqual([
+				'./src/**/*.ts',
+				'./api/**/*.ts',
+			]);
+		});
+
+		it('should wrap string in array', () => {
+			expect(normalizeRoutes('./src/**/*.ts')).toEqual(['./src/**/*.ts']);
+		});
+	});
+
+	describe('getFirstRoute', () => {
+		it('should return null for undefined', () => {
+			expect(getFirstRoute(undefined)).toBeNull();
+		});
+
+		it('should return first element of array', () => {
+			expect(getFirstRoute(['./src/**/*.ts', './api/**/*.ts'])).toBe(
+				'./src/**/*.ts',
+			);
+		});
+
+		it('should return string directly', () => {
+			expect(getFirstRoute('./src/**/*.ts')).toBe('./src/**/*.ts');
+		});
+
+		it('should return null for empty array', () => {
+			expect(getFirstRoute([])).toBeNull();
+		});
+	});
+
+	describe('shouldRegenerateClient', () => {
+		it('should return true for TypeScript files in routes directory', () => {
+			expect(
+				shouldRegenerateClient(
+					'apps/api/src/endpoints/users.ts',
+					'./src/endpoints/**/*.ts',
+				),
+			).toBe(true);
+		});
+
+		it('should return false for non-TypeScript files', () => {
+			expect(
+				shouldRegenerateClient(
+					'apps/api/src/endpoints/README.md',
+					'./src/endpoints/**/*.ts',
+				),
+			).toBe(false);
+		});
+
+		it('should return false for files outside routes pattern', () => {
+			expect(
+				shouldRegenerateClient(
+					'apps/api/src/utils/helpers.ts',
+					'./src/endpoints/**/*.ts',
+				),
+			).toBe(false);
+		});
+
+		it('should return true for .tsx files', () => {
+			expect(
+				shouldRegenerateClient(
+					'apps/api/src/endpoints/users.tsx',
+					'./src/endpoints/**/*.ts',
+				),
+			).toBe(true);
+		});
+	});
+
+	describe('getBackendDependencies', () => {
+		it('should return backend dependencies with routes', () => {
+			const workspace: NormalizedWorkspace = {
+				name: 'test',
+				root: '/test',
+				apps: {
+					api: {
+						type: 'backend',
+						path: 'apps/api',
+						port: 3000,
+						dependencies: [],
+						routes: './src/**/*.ts',
+					},
+					auth: {
+						type: 'backend',
+						path: 'apps/auth',
+						port: 3001,
+						dependencies: [],
+						routes: './src/**/*.ts',
+					},
+					web: {
+						type: 'frontend',
+						path: 'apps/web',
+						port: 3002,
+						dependencies: ['api', 'auth'],
+					},
+				},
+				services: {},
+				deploy: { default: 'dokploy' },
+				shared: { packages: [] },
+				secrets: {},
+			};
+
+			const deps = getBackendDependencies(workspace, 'web');
+			expect(deps).toEqual(['api', 'auth']);
+		});
+
+		it('should filter out backends without routes', () => {
+			const workspace: NormalizedWorkspace = {
+				name: 'test',
+				root: '/test',
+				apps: {
+					api: {
+						type: 'backend',
+						path: 'apps/api',
+						port: 3000,
+						dependencies: [],
+						routes: './src/**/*.ts',
+					},
+					worker: {
+						type: 'backend',
+						path: 'apps/worker',
+						port: 3001,
+						dependencies: [],
+						// No routes - not an HTTP backend
+					},
+					web: {
+						type: 'frontend',
+						path: 'apps/web',
+						port: 3002,
+						dependencies: ['api', 'worker'],
+					},
+				},
+				services: {},
+				deploy: { default: 'dokploy' },
+				shared: { packages: [] },
+				secrets: {},
+			};
+
+			const deps = getBackendDependencies(workspace, 'web');
+			expect(deps).toEqual(['api']);
+		});
+
+		it('should return empty array for non-frontend app', () => {
+			const workspace: NormalizedWorkspace = {
+				name: 'test',
+				root: '/test',
+				apps: {
+					api: {
+						type: 'backend',
+						path: 'apps/api',
+						port: 3000,
+						dependencies: [],
+						routes: './src/**/*.ts',
+					},
+				},
+				services: {},
+				deploy: { default: 'dokploy' },
+				shared: { packages: [] },
+				secrets: {},
+			};
+
+			const deps = getBackendDependencies(workspace, 'api');
+			expect(deps).toEqual([]);
+		});
+	});
+
+	describe('getDependentFrontends', () => {
+		it('should find frontends that depend on a backend', () => {
+			const workspace: NormalizedWorkspace = {
+				name: 'test',
+				root: '/test',
+				apps: {
+					api: {
+						type: 'backend',
+						path: 'apps/api',
+						port: 3000,
+						dependencies: [],
+						routes: './src/**/*.ts',
+					},
+					web: {
+						type: 'frontend',
+						path: 'apps/web',
+						port: 3001,
+						dependencies: ['api'],
+					},
+					admin: {
+						type: 'frontend',
+						path: 'apps/admin',
+						port: 3002,
+						dependencies: ['api'],
+					},
+					docs: {
+						type: 'frontend',
+						path: 'apps/docs',
+						port: 3003,
+						dependencies: [], // No API dependency
+					},
+				},
+				services: {},
+				deploy: { default: 'dokploy' },
+				shared: { packages: [] },
+				secrets: {},
+			};
+
+			const dependents = getDependentFrontends(workspace, 'api');
+			expect(dependents).toEqual(['web', 'admin']);
+		});
+
+		it('should return empty array for backend with no dependents', () => {
+			const workspace: NormalizedWorkspace = {
+				name: 'test',
+				root: '/test',
+				apps: {
+					api: {
+						type: 'backend',
+						path: 'apps/api',
+						port: 3000,
+						dependencies: [],
+						routes: './src/**/*.ts',
+					},
+				},
+				services: {},
+				deploy: { default: 'dokploy' },
+				shared: { packages: [] },
+				secrets: {},
+			};
+
+			const dependents = getDependentFrontends(workspace, 'api');
+			expect(dependents).toEqual([]);
+		});
+	});
+
+	describe('generateClientForFrontend', () => {
+		let testDir: string;
+
+		beforeEach(() => {
+			testDir = join(
+				tmpdir(),
+				`gkm-client-test-${Date.now()}-${Math.random().toString(36).slice(2)}`,
+			);
+			mkdirSync(testDir, { recursive: true });
+			clearSpecHashCache();
+		});
+
+		afterEach(() => {
+			if (existsSync(testDir)) {
+				rmSync(testDir, { recursive: true, force: true });
+			}
+		});
+
+		it('should return empty array for frontend with no backend dependencies', async () => {
+			const workspace: NormalizedWorkspace = {
+				name: 'test',
+				root: testDir,
+				apps: {
+					web: {
+						type: 'frontend',
+						path: 'apps/web',
+						port: 3001,
+						dependencies: [],
+					},
+				},
+				services: {},
+				deploy: { default: 'dokploy' },
+				shared: { packages: [] },
+				secrets: {},
+			};
+
+			const results = await generateClientForFrontend(workspace, 'web');
+			expect(results).toEqual([]);
+		});
+
+		it('should return empty array for non-frontend app', async () => {
+			const workspace: NormalizedWorkspace = {
+				name: 'test',
+				root: testDir,
+				apps: {
+					api: {
+						type: 'backend',
+						path: 'apps/api',
+						port: 3000,
+						dependencies: [],
+						routes: './src/**/*.ts',
+					},
+				},
+				services: {},
+				deploy: { default: 'dokploy' },
+				shared: { packages: [] },
+				secrets: {},
+			};
+
+			const results = await generateClientForFrontend(workspace, 'api');
+			expect(results).toEqual([]);
+		});
+
+		it('should use configured client output path', async () => {
+			// Create minimal workspace structure
+			const apiDir = join(testDir, 'apps/api');
+			const webDir = join(testDir, 'apps/web');
+			mkdirSync(join(apiDir, 'src/endpoints'), { recursive: true });
+			mkdirSync(webDir, { recursive: true });
+
+			const workspace: NormalizedWorkspace = {
+				name: 'test',
+				root: testDir,
+				apps: {
+					api: {
+						type: 'backend',
+						path: 'apps/api',
+						port: 3000,
+						dependencies: [],
+						routes: './src/endpoints/**/*.ts',
+					},
+					web: {
+						type: 'frontend',
+						path: 'apps/web',
+						port: 3001,
+						dependencies: ['api'],
+						client: { output: 'lib/api' },
+					},
+				},
+				services: {},
+				deploy: { default: 'dokploy' },
+				shared: { packages: [] },
+				secrets: {},
+			};
+
+			// This will fail to generate because there are no endpoints,
+			// but we can verify the output path would be correct
+			const results = await generateClientForFrontend(workspace, 'web');
+			expect(results).toHaveLength(1);
+			expect(results[0]?.reason).toBe('No endpoints found in backend');
+		});
+	});
+});