@geekmidas/cli 0.18.0 → 0.19.0

package/src/docker/__tests__/compose.spec.ts

@@ -1,10 +1,12 @@
 import { describe, expect, it } from 'vitest';
+import type { NormalizedWorkspace } from '../../workspace/types.js';
 import {
 	type ComposeOptions,
 	DEFAULT_SERVICE_IMAGES,
 	DEFAULT_SERVICE_VERSIONS,
 	generateDockerCompose,
 	generateMinimalDockerCompose,
+	generateWorkspaceCompose,
 } from '../compose';
 
 /** Helper to get full default image reference */
@@ -529,3 +531,426 @@ describe('generateMinimalDockerCompose', () => {
 		expect(yaml).toContain('image: ${IMAGE_NAME:-minimal-api}:${TAG:-latest}');
 	});
 });
+
+describe('generateWorkspaceCompose', () => {
+	/** Create a minimal workspace config for testing */
+	function createWorkspace(
+		overrides: Partial<NormalizedWorkspace> = {},
+	): NormalizedWorkspace {
+		return {
+			name: 'test-workspace',
+			root: '/workspace',
+			apps: {
+				api: {
+					type: 'backend',
+					path: 'apps/api',
+					port: 3000,
+					dependencies: [],
+				},
+				web: {
+					type: 'frontend',
+					path: 'apps/web',
+					port: 3001,
+					dependencies: ['api'],
+					framework: 'nextjs',
+				},
+			},
+			services: {},
+			deploy: { default: 'dokploy' },
+			shared: { packages: [] },
+			secrets: {},
+			...overrides,
+		};
+	}
+
+	describe('header and structure', () => {
+		it('should include workspace name in header comment', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('# Docker Compose for test-workspace workspace');
+		});
+
+		it('should include generated file warning', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('# Generated by gkm - do not edit manually');
+		});
+
+		it('should include services section', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('services:');
+		});
+
+		it('should include networks section', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('networks:');
+			expect(yaml).toContain('workspace-network:');
+			expect(yaml).toContain('driver: bridge');
+		});
+	});
+
+	describe('app services', () => {
+		it('should generate service for each app', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('api:');
+			expect(yaml).toContain('web:');
+		});
+
+		it('should reference correct Dockerfile for each app', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('dockerfile: .gkm/docker/Dockerfile.api');
+			expect(yaml).toContain('dockerfile: .gkm/docker/Dockerfile.web');
+		});
+
+		it('should set container name from app name', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('container_name: api');
+			expect(yaml).toContain('container_name: web');
+		});
+
+		it('should configure port mapping for each app', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('"${API_PORT:-3000}:3000"');
+			expect(yaml).toContain('"${WEB_PORT:-3001}:3001"');
+		});
+
+		it('should set PORT environment variable for each app', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('- PORT=3000');
+			expect(yaml).toContain('- PORT=3001');
+		});
+
+		it('should set NODE_ENV to production for all apps', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace);
+
+			const matches = yaml.match(/- NODE_ENV=production/g);
+			expect(matches?.length).toBe(2);
+		});
+
+		it('should configure restart policy for all apps', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace);
+
+			const matches = yaml.match(/restart: unless-stopped/g);
+			expect(matches?.length).toBeGreaterThanOrEqual(2);
+		});
+
+		it('should attach all apps to workspace-network', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace);
+
+			const matches = yaml.match(/- workspace-network/g);
+			expect(matches?.length).toBeGreaterThanOrEqual(2);
+		});
+	});
+
+	describe('service discovery', () => {
+		it('should add dependency URLs for frontend apps', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace);
+
+			// web depends on api, so should have API_URL
+			expect(yaml).toContain('- API_URL=http://api:3000');
+		});
+
+		it('should handle multiple dependencies', () => {
+			const workspace = createWorkspace({
+				apps: {
+					api: {
+						type: 'backend',
+						path: 'apps/api',
+						port: 3000,
+						dependencies: [],
+					},
+					auth: {
+						type: 'backend',
+						path: 'apps/auth',
+						port: 3002,
+						dependencies: [],
+					},
+					web: {
+						type: 'frontend',
+						path: 'apps/web',
+						port: 3001,
+						dependencies: ['api', 'auth'],
+						framework: 'nextjs',
+					},
+				},
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('- API_URL=http://api:3000');
+			expect(yaml).toContain('- AUTH_URL=http://auth:3002');
+		});
+
+		it('should not add dependency URLs for apps with no dependencies', () => {
+			const workspace = createWorkspace({
+				apps: {
+					api: {
+						type: 'backend',
+						path: 'apps/api',
+						port: 3000,
+						dependencies: [],
+					},
+				},
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			// api has no dependencies, so no *_URL vars
+			expect(yaml).not.toMatch(/_URL=http:\/\//);
+		});
+	});
+
+	describe('health checks', () => {
+		it('should configure health check for backend apps at /health', () => {
+			const workspace = createWorkspace({
+				apps: {
+					api: {
+						type: 'backend',
+						path: 'apps/api',
+						port: 3000,
+						dependencies: [],
+					},
+				},
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('http://localhost:3000/health');
+		});
+
+		it('should configure health check for frontend apps at /', () => {
+			const workspace = createWorkspace({
+				apps: {
+					web: {
+						type: 'frontend',
+						path: 'apps/web',
+						port: 3001,
+						dependencies: [],
+						framework: 'nextjs',
+					},
+				},
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('http://localhost:3001/');
+		});
+	});
+
+	describe('depends_on', () => {
+		it('should add depends_on for app dependencies', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace);
+
+			// web depends on api
+			expect(yaml).toContain('depends_on:');
+			expect(yaml).toContain('condition: service_healthy');
+		});
+
+		it('should not add depends_on for apps without dependencies', () => {
+			const workspace = createWorkspace({
+				apps: {
+					api: {
+						type: 'backend',
+						path: 'apps/api',
+						port: 3000,
+						dependencies: [],
+					},
+				},
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			// api section should not have depends_on
+			const apiSection = yaml.split('api:')[1]?.split(/^ {2}\w+:/m)[0];
+			expect(apiSection).not.toContain('depends_on:');
+		});
+	});
+
+	describe('infrastructure services', () => {
+		it('should add postgres service when db is configured', () => {
+			const workspace = createWorkspace({
+				services: { db: true },
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('postgres:');
+			expect(yaml).toContain('image: postgres:16-alpine');
+			expect(yaml).toContain('container_name: test-workspace-postgres');
+		});
+
+		it('should add DATABASE_URL for backend apps when postgres is enabled', () => {
+			const workspace = createWorkspace({
+				services: { db: true },
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain(
+				'DATABASE_URL=${DATABASE_URL:-postgresql://postgres:postgres@postgres:5432/app}',
+			);
+		});
+
+		it('should add redis service when cache is configured', () => {
+			const workspace = createWorkspace({
+				services: { cache: true },
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('redis:');
+			expect(yaml).toContain('image: redis:7-alpine');
+			expect(yaml).toContain('container_name: test-workspace-redis');
+		});
+
+		it('should add REDIS_URL for backend apps when redis is enabled', () => {
+			const workspace = createWorkspace({
+				services: { cache: true },
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('REDIS_URL=${REDIS_URL:-redis://redis:6379}');
+		});
+
+		it('should add mailpit service when mail is configured', () => {
+			const workspace = createWorkspace({
+				services: { mail: true },
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('mailpit:');
+			expect(yaml).toContain('image: axllent/mailpit:latest');
+			expect(yaml).toContain('- "8025:8025"'); // Web UI
+			expect(yaml).toContain('- "1025:1025"'); // SMTP
+		});
+
+		it('should add postgres_data volume when postgres is enabled', () => {
+			const workspace = createWorkspace({
+				services: { db: true },
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('postgres_data:');
+			expect(yaml).toContain('postgres_data:/var/lib/postgresql/data');
+		});
+
+		it('should add redis_data volume when redis is enabled', () => {
+			const workspace = createWorkspace({
+				services: { cache: true },
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('redis_data:');
+			expect(yaml).toContain('redis_data:/data');
+		});
+
+		it('should include healthchecks for infrastructure services', () => {
+			const workspace = createWorkspace({
+				services: { db: true, cache: true },
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('pg_isready');
+			expect(yaml).toContain('redis-cli');
+		});
+
+		it('should add depends_on for infrastructure services', () => {
+			const workspace = createWorkspace({
+				services: { db: true, cache: true },
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			// Backend apps should depend on postgres and redis
+			expect(yaml).toMatch(/postgres:\s+condition: service_healthy/);
+			expect(yaml).toMatch(/redis:\s+condition: service_healthy/);
+		});
+
+		it('should not add infrastructure depends_on for frontend apps', () => {
+			const workspace = createWorkspace({
+				apps: {
+					web: {
+						type: 'frontend',
+						path: 'apps/web',
+						port: 3001,
+						dependencies: [],
+						framework: 'nextjs',
+					},
+				},
+				services: { db: true },
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			// Frontend should not depend on postgres
+			const webSection = yaml.split('web:')[1]?.split(/^ {2}\w+:/m)[0];
+			expect(webSection).not.toContain('postgres:');
+		});
+
+		it('should support custom postgres version', () => {
+			const workspace = createWorkspace({
+				services: { db: { version: '15-alpine' } },
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('image: postgres:15-alpine');
+		});
+
+		it('should support custom postgres image', () => {
+			const workspace = createWorkspace({
+				services: { db: { image: 'postgis/postgis:16-3.4-alpine' } },
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('image: postgis/postgis:16-3.4-alpine');
+		});
+
+		it('should support custom redis version', () => {
+			const workspace = createWorkspace({
+				services: { cache: { version: '6-alpine' } },
+			});
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('image: redis:6-alpine');
+		});
+	});
+
+	describe('registry configuration', () => {
+		it('should include registry when provided', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace, {
+				registry: 'ghcr.io/myorg',
+			});
+
+			expect(yaml).toContain('${REGISTRY:-ghcr.io/myorg}/');
+		});
+
+		it('should work without registry', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).not.toContain('${REGISTRY');
+		});
+	});
+
+	describe('image naming', () => {
+		it('should use app name for image with environment override', () => {
+			const workspace = createWorkspace();
+			const yaml = generateWorkspaceCompose(workspace);
+
+			expect(yaml).toContain('${API_IMAGE:-api}:${TAG:-latest}');
+			expect(yaml).toContain('${WEB_IMAGE:-web}:${TAG:-latest}');
+		});
+	});
+});

package/src/docker/__tests__/templates.spec.ts

@@ -5,9 +5,11 @@ import type { GkmConfig } from '../../types';
 import {
 	detectPackageManager,
 	findLockfilePath,
+	generateBackendDockerfile,
 	generateDockerEntrypoint,
 	generateDockerignore,
 	generateMultiStageDockerfile,
+	generateNextjsDockerfile,
 	generateSlimDockerfile,
 	getLockfileName,
 	hasTurboConfig,
@@ -421,4 +423,147 @@ describe('docker templates', () => {
 			expect(hasTurboConfig('/test/project')).toBe(false);
 		});
 	});
+
+	describe('generateNextjsDockerfile', () => {
+		const baseOptions = {
+			imageName: 'web',
+			baseImage: 'node:22-alpine',
+			port: 3001,
+			appPath: 'apps/web',
+			turboPackage: '@myapp/web',
+			packageManager: 'pnpm' as const,
+		};
+
+		it('should generate Next.js standalone Dockerfile', () => {
+			const dockerfile = generateNextjsDockerfile(baseOptions);
+
+			expect(dockerfile).toContain('# Next.js standalone Dockerfile');
+		});
+
+		it('should include four stages: pruner, deps, builder, runner', () => {
+			const dockerfile = generateNextjsDockerfile(baseOptions);
+
+			expect(dockerfile).toContain('AS pruner');
+			expect(dockerfile).toContain('AS deps');
+			expect(dockerfile).toContain('AS builder');
+			expect(dockerfile).toContain('AS runner');
+		});
+
+		it('should use turbo prune for monorepo optimization', () => {
+			const dockerfile = generateNextjsDockerfile(baseOptions);
+
+			expect(dockerfile).toContain('turbo prune @myapp/web --docker');
+		});
+
+		it('should copy standalone output', () => {
+			const dockerfile = generateNextjsDockerfile(baseOptions);
+
+			expect(dockerfile).toContain('.next/standalone');
+			expect(dockerfile).toContain('.next/static');
+		});
+
+		it('should set NEXT_TELEMETRY_DISABLED', () => {
+			const dockerfile = generateNextjsDockerfile(baseOptions);
+
+			expect(dockerfile).toContain('NEXT_TELEMETRY_DISABLED=1');
+		});
+
+		it('should create nextjs user', () => {
+			const dockerfile = generateNextjsDockerfile(baseOptions);
+
+			expect(dockerfile).toContain('adduser --system --uid 1001 nextjs');
+			expect(dockerfile).toContain('USER nextjs');
+		});
+
+		it('should expose configured port', () => {
+			const dockerfile = generateNextjsDockerfile(baseOptions);
+
+			expect(dockerfile).toContain('EXPOSE 3001');
+			expect(dockerfile).toContain('ENV PORT=3001');
+		});
+
+		it('should use npm when specified', () => {
+			const dockerfile = generateNextjsDockerfile({
+				...baseOptions,
+				packageManager: 'npm',
+			});
+
+			expect(dockerfile).toContain('npx turbo');
+			expect(dockerfile).toContain('package-lock.json');
+		});
+	});
+
+	describe('generateBackendDockerfile', () => {
+		const baseOptions = {
+			imageName: 'api',
+			baseImage: 'node:22-alpine',
+			port: 3000,
+			appPath: 'apps/api',
+			turboPackage: '@myapp/api',
+			packageManager: 'pnpm' as const,
+		};
+
+		it('should generate backend Dockerfile with turbo prune', () => {
+			const dockerfile = generateBackendDockerfile(baseOptions);
+
+			expect(dockerfile).toContain('# Backend Dockerfile with turbo prune');
+		});
+
+		it('should include four stages: pruner, deps, builder, runner', () => {
+			const dockerfile = generateBackendDockerfile(baseOptions);
+
+			expect(dockerfile).toContain('AS pruner');
+			expect(dockerfile).toContain('AS deps');
+			expect(dockerfile).toContain('AS builder');
+			expect(dockerfile).toContain('AS runner');
+		});
+
+		it('should use turbo prune for the package', () => {
+			const dockerfile = generateBackendDockerfile(baseOptions);
+
+			expect(dockerfile).toContain('turbo prune @myapp/api --docker');
+		});
+
+		it('should build using gkm', () => {
+			const dockerfile = generateBackendDockerfile(baseOptions);
+
+			expect(dockerfile).toContain('gkm build --provider server --production');
+		});
+
+		it('should copy bundled server.mjs', () => {
+			const dockerfile = generateBackendDockerfile(baseOptions);
+
+			expect(dockerfile).toContain('.gkm/server/dist/server.mjs');
+		});
+
+		it('should create hono user', () => {
+			const dockerfile = generateBackendDockerfile(baseOptions);
+
+			expect(dockerfile).toContain('adduser --system --uid 1001 hono');
+			expect(dockerfile).toContain('USER hono');
+		});
+
+		it('should include health check with default path', () => {
+			const dockerfile = generateBackendDockerfile(baseOptions);
+
+			expect(dockerfile).toContain('HEALTHCHECK');
+			expect(dockerfile).toContain('/health');
+		});
+
+		it('should use custom health check path when provided', () => {
+			const dockerfile = generateBackendDockerfile({
+				...baseOptions,
+				healthCheckPath: '/api/health',
+			});
+
+			expect(dockerfile).toContain('/api/health');
+		});
+
+		it('should expose configured port', () => {
+			const dockerfile = generateBackendDockerfile(baseOptions);
+
+			expect(dockerfile).toContain('EXPOSE 3000');
+			expect(dockerfile).toContain('ENV PORT=3000');
+		});
+	});
 });