@geekmidas/cli 0.3.0 → 0.5.0

package/src/init/templates/minimal.ts

@@ -0,0 +1,102 @@
+import type {
+  GeneratedFile,
+  TemplateConfig,
+  TemplateOptions,
+} from './index.js';
+
+export const minimalTemplate: TemplateConfig = {
+  name: 'minimal',
+  description: 'Basic health endpoint',
+
+  dependencies: {
+    '@geekmidas/constructs': 'workspace:*',
+    '@geekmidas/envkit': 'workspace:*',
+    '@geekmidas/logger': 'workspace:*',
+    hono: '~4.8.2',
+    pino: '~9.6.0',
+  },
+
+  devDependencies: {
+    '@biomejs/biome': '~1.9.4',
+    '@geekmidas/cli': 'workspace:*',
+    '@types/node': '~22.0.0',
+    tsx: '~4.20.0',
+    turbo: '~2.3.0',
+    typescript: '~5.8.2',
+    vitest: '~4.0.0',
+  },
+
+  scripts: {
+    dev: 'gkm dev',
+    build: 'gkm build',
+    test: 'vitest',
+    'test:once': 'vitest run',
+    typecheck: 'tsc --noEmit',
+    lint: 'biome lint .',
+    fmt: 'biome format . --write',
+    'fmt:check': 'biome format .',
+  },
+
+  files: (options: TemplateOptions): GeneratedFile[] => {
+    const files: GeneratedFile[] = [
+      // src/config/env.ts
+      {
+        path: 'src/config/env.ts',
+        content: `import { EnvironmentParser } from '@geekmidas/envkit';
+
+export const envParser = new EnvironmentParser(process.env);
+
+export const config = envParser
+  .create((get) => ({
+    port: get('PORT').string().transform(Number).default(3000),
+    nodeEnv: get('NODE_ENV').string().default('development'),
+  }))
+  .parse();
+`,
+      },
+
+      // src/config/logger.ts - using pino
+      {
+        path: 'src/config/logger.ts',
+        content: `import { PinoLogger } from '@geekmidas/logger/pino';
+
+export const logger = new PinoLogger({
+  app: '${options.name}',
+  level: process.env.LOG_LEVEL || 'info',
+});
+`,
+      },
+
+      // src/endpoints/health.ts
+      {
+        path: 'src/endpoints/health.ts',
+        content: `import { e } from '@geekmidas/constructs/endpoints';
+
+export default e
+  .get('/health')
+  .handle(async () => ({
+    status: 'ok',
+    timestamp: new Date().toISOString(),
+  }));
+`,
+      },
+    ];
+
+    // Add Telescope config if enabled
+    if (options.telescope) {
+      files.push({
+        path: 'src/config/telescope.ts',
+        content: `import { Telescope } from '@geekmidas/telescope';
+import { InMemoryStorage } from '@geekmidas/telescope/storage/memory';
+
+export const telescope = new Telescope({
+  storage: new InMemoryStorage({ maxEntries: 100 }),
+  enabled: process.env.NODE_ENV === 'development',
+});
+`,
+      });
+    }
+
+    return files;
+  },
+};

package/src/init/templates/serverless.ts

@@ -0,0 +1,129 @@
+import type {
+  GeneratedFile,
+  TemplateConfig,
+  TemplateOptions,
+} from './index.js';
+
+export const serverlessTemplate: TemplateConfig = {
+  name: 'serverless',
+  description: 'AWS Lambda handlers',
+
+  dependencies: {
+    '@geekmidas/constructs': 'workspace:*',
+    '@geekmidas/envkit': 'workspace:*',
+    '@geekmidas/logger': 'workspace:*',
+    '@geekmidas/cloud': 'workspace:*',
+    hono: '~4.8.2',
+    pino: '~9.6.0',
+  },
+
+  devDependencies: {
+    '@biomejs/biome': '~1.9.4',
+    '@geekmidas/cli': 'workspace:*',
+    '@types/aws-lambda': '~8.10.92',
+    '@types/node': '~22.0.0',
+    tsx: '~4.20.0',
+    turbo: '~2.3.0',
+    typescript: '~5.8.2',
+    vitest: '~4.0.0',
+  },
+
+  scripts: {
+    dev: 'gkm dev',
+    build: 'gkm build --provider aws-apigatewayv2',
+    test: 'vitest',
+    'test:once': 'vitest run',
+    typecheck: 'tsc --noEmit',
+    lint: 'biome lint .',
+    fmt: 'biome format . --write',
+    'fmt:check': 'biome format .',
+  },
+
+  files: (options: TemplateOptions): GeneratedFile[] => {
+    const files: GeneratedFile[] = [
+      // src/config/env.ts
+      {
+        path: 'src/config/env.ts',
+        content: `import { EnvironmentParser } from '@geekmidas/envkit';
+
+export const envParser = new EnvironmentParser(process.env);
+
+export const config = envParser
+  .create((get) => ({
+    stage: get('STAGE').string().default('dev'),
+    region: get('AWS_REGION').string().default('us-east-1'),${
+      options.database
+        ? `
+    database: {
+      url: get('DATABASE_URL').string(),
+    },`
+        : ''
+    }
+  }))
+  .parse();
+`,
+      },
+
+      // src/config/logger.ts - using pino
+      {
+        path: 'src/config/logger.ts',
+        content: `import { PinoLogger } from '@geekmidas/logger/pino';
+
+export const logger = new PinoLogger({
+  app: '${options.name}',
+  stage: process.env.STAGE || 'dev',
+  level: process.env.LOG_LEVEL || 'info',
+});
+`,
+      },
+
+      // src/endpoints/health.ts
+      {
+        path: 'src/endpoints/health.ts',
+        content: `import { e } from '@geekmidas/constructs/endpoints';
+
+export default e
+  .get('/health')
+  .handle(async () => ({
+    status: 'ok',
+    timestamp: new Date().toISOString(),
+    region: process.env.AWS_REGION || 'local',
+  }));
+`,
+      },
+
+      // src/functions/hello.ts
+      {
+        path: 'src/functions/hello.ts',
+        content: `import { f } from '@geekmidas/constructs/functions';
+import { z } from 'zod';
+
+export default f
+  .input(z.object({ name: z.string() }))
+  .output(z.object({ message: z.string() }))
+  .handle(async ({ input }) => ({
+    message: \`Hello, \${input.name}!\`,
+  }));
+`,
+      },
+    ];
+
+    // Add Telescope config if enabled
+    if (options.telescope) {
+      files.push({
+        path: 'src/config/telescope.ts',
+        content: `import { Telescope } from '@geekmidas/telescope';
+import { InMemoryStorage } from '@geekmidas/telescope/storage/memory';
+
+// Note: For production Lambda, consider using a persistent storage
+export const telescope = new Telescope({
+  storage: new InMemoryStorage({ maxEntries: 50 }),
+  enabled: process.env.STAGE === 'dev',
+});
+`,
+      });
+    }
+
+    return files;
+  },
+};

package/src/init/templates/worker.ts

@@ -0,0 +1,169 @@
+import type {
+  GeneratedFile,
+  TemplateConfig,
+  TemplateOptions,
+} from './index.js';
+
+export const workerTemplate: TemplateConfig = {
+  name: 'worker',
+  description: 'Background job processing',
+
+  dependencies: {
+    '@geekmidas/constructs': 'workspace:*',
+    '@geekmidas/envkit': 'workspace:*',
+    '@geekmidas/logger': 'workspace:*',
+    '@geekmidas/events': 'workspace:*',
+    hono: '~4.8.2',
+    pino: '~9.6.0',
+  },
+
+  devDependencies: {
+    '@biomejs/biome': '~1.9.4',
+    '@geekmidas/cli': 'workspace:*',
+    '@types/node': '~22.0.0',
+    tsx: '~4.20.0',
+    turbo: '~2.3.0',
+    typescript: '~5.8.2',
+    vitest: '~4.0.0',
+  },
+
+  scripts: {
+    dev: 'gkm dev',
+    build: 'gkm build',
+    test: 'vitest',
+    'test:once': 'vitest run',
+    typecheck: 'tsc --noEmit',
+    lint: 'biome lint .',
+    fmt: 'biome format . --write',
+    'fmt:check': 'biome format .',
+  },
+
+  files: (options: TemplateOptions): GeneratedFile[] => {
+    const files: GeneratedFile[] = [
+      // src/config/env.ts
+      {
+        path: 'src/config/env.ts',
+        content: `import { EnvironmentParser } from '@geekmidas/envkit';
+
+export const envParser = new EnvironmentParser(process.env);
+
+export const config = envParser
+  .create((get) => ({
+    port: get('PORT').string().transform(Number).default(3000),
+    nodeEnv: get('NODE_ENV').string().default('development'),
+    rabbitmq: {
+      url: get('RABBITMQ_URL').string().default('amqp://localhost:5672'),
+    },${
+      options.database
+        ? `
+    database: {
+      url: get('DATABASE_URL').string().default('postgresql://localhost:5432/mydb'),
+    },`
+        : ''
+    }
+  }))
+  .parse();
+`,
+      },
+
+      // src/config/logger.ts - using pino
+      {
+        path: 'src/config/logger.ts',
+        content: `import { PinoLogger } from '@geekmidas/logger/pino';
+
+export const logger = new PinoLogger({
+  app: '${options.name}',
+  level: process.env.LOG_LEVEL || 'info',
+});
+`,
+      },
+
+      // src/endpoints/health.ts
+      {
+        path: 'src/endpoints/health.ts',
+        content: `import { e } from '@geekmidas/constructs/endpoints';
+
+export default e
+  .get('/health')
+  .handle(async () => ({
+    status: 'ok',
+    timestamp: new Date().toISOString(),
+  }));
+`,
+      },
+
+      // src/events/types.ts
+      {
+        path: 'src/events/types.ts',
+        content: `import type { PublishableMessage } from '@geekmidas/events';
+
+// Define your event types here
+export type AppEvents =
+  | PublishableMessage<'user.created', { userId: string; email: string }>
+  | PublishableMessage<'user.updated', { userId: string; changes: Record<string, unknown> }>
+  | PublishableMessage<'order.placed', { orderId: string; userId: string; total: number }>;
+`,
+      },
+
+      // src/subscribers/user-events.ts
+      {
+        path: 'src/subscribers/user-events.ts',
+        content: `import { s } from '@geekmidas/constructs/subscribers';
+import type { AppEvents } from '../events/types.js';
+
+export default s<AppEvents>()
+  .events(['user.created', 'user.updated'])
+  .handle(async ({ event, logger }) => {
+    logger.info({ type: event.type, payload: event.payload }, 'Processing user event');
+
+    switch (event.type) {
+      case 'user.created':
+        // Handle user creation
+        logger.info({ userId: event.payload.userId }, 'New user created');
+        break;
+      case 'user.updated':
+        // Handle user update
+        logger.info({ userId: event.payload.userId }, 'User updated');
+        break;
+    }
+  });
+`,
+      },
+
+      // src/crons/cleanup.ts
+      {
+        path: 'src/crons/cleanup.ts',
+        content: `import { cron } from '@geekmidas/constructs/crons';
+
+// Run every day at midnight
+export default cron('0 0 * * *')
+  .handle(async ({ logger }) => {
+    logger.info('Running cleanup job');
+
+    // Add your cleanup logic here
+    // e.g., delete old sessions, clean up temp files, etc.
+
+    logger.info('Cleanup job completed');
+  });
+`,
+      },
+    ];
+
+    // Add Telescope config if enabled
+    if (options.telescope) {
+      files.push({
+        path: 'src/config/telescope.ts',
+        content: `import { Telescope } from '@geekmidas/telescope';
+import { InMemoryStorage } from '@geekmidas/telescope/storage/memory';
+
+export const telescope = new Telescope({
+  storage: new InMemoryStorage({ maxEntries: 100 }),
+  enabled: process.env.NODE_ENV === 'development',
+});
+`,
+      });
+    }
+
+    return files;
+  },
+};

package/src/init/utils.ts

@@ -0,0 +1,98 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+export type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
+
+/**
+ * Detect the package manager being used based on lockfiles or npm_config_user_agent
+ */
+export function detectPackageManager(
+  cwd: string = process.cwd(),
+): PackageManager {
+  // Check for lockfiles in cwd
+  if (existsSync(join(cwd, 'pnpm-lock.yaml'))) return 'pnpm';
+  if (existsSync(join(cwd, 'yarn.lock'))) return 'yarn';
+  if (existsSync(join(cwd, 'bun.lockb'))) return 'bun';
+  if (existsSync(join(cwd, 'package-lock.json'))) return 'npm';
+
+  // Check npm_config_user_agent (set when running via npx/pnpm dlx/etc)
+  const userAgent = process.env.npm_config_user_agent || '';
+  if (userAgent.includes('pnpm')) return 'pnpm';
+  if (userAgent.includes('yarn')) return 'yarn';
+  if (userAgent.includes('bun')) return 'bun';
+
+  return 'npm';
+}
+
+/**
+ * Validate project name for npm package naming conventions
+ */
+export function validateProjectName(name: string): boolean | string {
+  if (!name) {
+    return 'Project name is required';
+  }
+
+  // Check for valid npm package name characters
+  if (!/^[a-z0-9-_@/.]+$/i.test(name)) {
+    return 'Project name can only contain letters, numbers, hyphens, underscores, @, /, and .';
+  }
+
+  // Check for reserved names
+  const reserved = ['node_modules', '.git', 'package.json', 'src'];
+  if (reserved.includes(name.toLowerCase())) {
+    return `"${name}" is a reserved name`;
+  }
+
+  return true;
+}
+
+/**
+ * Check if a directory already exists at the target path
+ */
+export function checkDirectoryExists(
+  name: string,
+  cwd: string = process.cwd(),
+): boolean | string {
+  const targetPath = join(cwd, name);
+  if (existsSync(targetPath)) {
+    return `Directory "${name}" already exists`;
+  }
+  return true;
+}
+
+/**
+ * Get the install command for a package manager
+ */
+export function getInstallCommand(pkgManager: PackageManager): string {
+  switch (pkgManager) {
+    case 'pnpm':
+      return 'pnpm install';
+    case 'yarn':
+      return 'yarn';
+    case 'bun':
+      return 'bun install';
+    case 'npm':
+    default:
+      return 'npm install';
+  }
+}
+
+/**
+ * Get the dev command for a package manager
+ */
+export function getRunCommand(
+  pkgManager: PackageManager,
+  script: string,
+): string {
+  switch (pkgManager) {
+    case 'pnpm':
+      return `pnpm ${script}`;
+    case 'yarn':
+      return `yarn ${script}`;
+    case 'bun':
+      return `bun run ${script}`;
+    case 'npm':
+    default:
+      return `npm run ${script}`;
+  }
+}

package/src/openapi.ts

@@ -1,13 +1,16 @@
 #!/usr/bin/env -S npx tsx
 
 import { mkdir, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
+import { dirname, join } from 'node:path';
 import { Endpoint } from '@geekmidas/constructs/endpoints';
 import { loadConfig } from './config.js';
 import { EndpointGenerator } from './generators/EndpointGenerator.js';
+import { OpenApiTsGenerator } from './generators/OpenApiTsGenerator.js';
 
 interface OpenAPIOptions {
   output?: string;
+  json?: boolean;
+  cwd?: string;
 }
 
 export async function openapiCommand(
@@ -17,11 +20,11 @@ export async function openapiCommand(
 
   try {
     // Load config using existing function
-    const config = await loadConfig();
-    const generator = new EndpointGenerator();
+    const config = await loadConfig(options.cwd);
+    const endpointGenerator = new EndpointGenerator();
 
     // Load all endpoints using the refactored function
-    const loadedEndpoints = await generator.load(config.routes);
+    const loadedEndpoints = await endpointGenerator.load(config.routes);
 
     if (loadedEndpoints.length === 0) {
       logger.log('No valid endpoints found');
@@ -31,19 +34,37 @@ export async function openapiCommand(
     // Extract just the endpoint instances for OpenAPI generation
     const endpoints = loadedEndpoints.map(({ construct }) => construct);
 
-    // Generate OpenAPI spec using built-in method
-    const spec = await Endpoint.buildOpenApiSchema(endpoints, {
-      title: 'API Documentation',
-      version: '1.0.0',
-      description: 'Auto-generated API documentation from endpoints',
-    });
+    // Determine output format (TypeScript is default)
+    const isJson = options.json === true;
+    const defaultOutput = isJson ? 'openapi.json' : 'openapi.ts';
+    const outputPath = options.output || join(process.cwd(), defaultOutput);
 
-    // Write output
-    const outputPath = options.output || join(process.cwd(), 'openapi.json');
-    await mkdir(join(outputPath, '..'), { recursive: true });
-    await writeFile(outputPath, JSON.stringify(spec, null, 2));
+    // Ensure output directory exists
+    await mkdir(dirname(outputPath), { recursive: true });
+
+    if (isJson) {
+      // Generate JSON OpenAPI spec (legacy)
+      const spec = await Endpoint.buildOpenApiSchema(endpoints, {
+        title: 'API Documentation',
+        version: '1.0.0',
+        description: 'Auto-generated API documentation from endpoints',
+      });
+
+      await writeFile(outputPath, JSON.stringify(spec, null, 2));
+      logger.log(`OpenAPI JSON spec generated: ${outputPath}`);
+    } else {
+      // Generate TypeScript OpenAPI module (default)
+      const tsGenerator = new OpenApiTsGenerator();
+      const tsContent = await tsGenerator.generate(endpoints, {
+        title: 'API Documentation',
+        version: '1.0.0',
+        description: 'Auto-generated API documentation from endpoints',
+      });
+
+      await writeFile(outputPath, tsContent);
+      logger.log(`OpenAPI TypeScript module generated: ${outputPath}`);
+    }
 
-    logger.log(`OpenAPI spec generated: ${outputPath}`);
     logger.log(`Found ${endpoints.length} endpoints`);
   } catch (error) {
     throw new Error(`OpenAPI generation failed: ${(error as Error).message}`);

package/src/types.ts

@@ -25,6 +25,25 @@ export interface ServerConfig extends ProviderConfig {
   port?: number;
 }
 
+export type Runtime = 'node' | 'bun';
+
+export interface TelescopeConfig {
+  /** Enable/disable telescope (default: true in development) */
+  enabled?: boolean;
+  /** Port for telescope to use (defaults to server port) */
+  port?: number;
+  /** Path prefix for telescope UI (default: /__telescope) */
+  path?: string;
+  /** Ignore patterns for telescope (e.g., ['/health', '/metrics']) */
+  ignore?: string[];
+  /** Record request/response bodies (default: true) */
+  recordBody?: boolean;
+  /** Maximum entries to keep in memory (default: 1000) */
+  maxEntries?: number;
+  /** Enable WebSocket for real-time updates (default: true, requires @hono/node-ws for Node.js) */
+  websocket?: boolean;
+}
+
 export interface ProvidersConfig {
   aws?: {
     apiGateway?: {
@@ -47,6 +66,30 @@ export interface GkmConfig {
   envParser: string;
   logger: string;
   providers?: ProvidersConfig;
+  /**
+   * Telescope configuration for debugging/monitoring.
+   * Can be:
+   * - A string path to a module that exports a Telescope instance (recommended)
+   * - A boolean to enable/disable with defaults
+   * - A TelescopeConfig object for inline configuration
+   */
+  telescope?: string | boolean | TelescopeConfig;
+  /** Runtime to use for dev server (default: 'node') */
+  runtime?: Runtime;
+  /**
+   * Environment file(s) to load for development.
+   * Can be:
+   * - A string path to a single env file (e.g., '.env.local')
+   * - An array of paths to load in order (later files override earlier)
+   * - Defaults to '.env' if not specified
+   *
+   * @example
+   * env: '.env.local'
+   *
+   * @example
+   * env: ['.env', '.env.local']
+   */
+  env?: string | string[];
 }
 
 export interface BuildOptions {

package/tsdown.config.ts

@@ -1,6 +1,6 @@
 import { defineConfig } from 'tsdown';
 
 export default defineConfig({
-  dts: false,
+  dts: true,
   format: ['cjs', 'esm'],
 });

package/dist/EndpointGenerator-C73wNoih.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"EndpointGenerator-C73wNoih.cjs","names":["ConstructGenerator","value: any","context: BuildContext","constructs: GeneratedConstruct<\n      Endpoint<\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any\n      >\n    >[]","outputDir: string","options?: GeneratorOptions","routes: RouteInfo[]","routeInfo: RouteInfo","sourceFile: string","exportName: string","provider: LegacyProvider","_endpoint: Endpoint<\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any\n    >","content: string","endpoints: GeneratedConstruct<\n      Endpoint<\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any\n      >\n    >[]","exports","importPath: string","envParserPath: string","envParserImportPattern: string"],"sources":["../src/generators/EndpointGenerator.ts"],"sourcesContent":["import { mkdir, writeFile } from 'node:fs/promises';\nimport { dirname, join, relative } from 'node:path';\nimport { Endpoint } from '@geekmidas/constructs/endpoints';\nimport type { BuildContext } from '../build/types';\nimport type { LegacyProvider, RouteInfo } from '../types';\nimport {\n  ConstructGenerator,\n  type GeneratedConstruct,\n  type GeneratorOptions,\n} from './Generator';\n\nexport class EndpointGenerator extends ConstructGenerator<\n  Endpoint<\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any\n  >,\n  RouteInfo[]\n> {\n  isConstruct(\n    value: any,\n  ): value is Endpoint<\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any\n  > {\n    return Endpoint.isEndpoint(value);\n  }\n\n  async build(\n    context: BuildContext,\n    constructs: GeneratedConstruct<\n      Endpoint<\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any\n      >\n    >[],\n    outputDir: string,\n    options?: GeneratorOptions,\n  ): Promise<RouteInfo[]> {\n    const provider = options?.provider || 'aws-apigatewayv2';\n    const enableOpenApi = options?.enableOpenApi || false;\n    const logger = console;\n    const routes: RouteInfo[] = [];\n\n    if (constructs.length === 0) {\n      return routes;\n    }\n\n    if (provider === 'server') {\n      // Generate endpoints.ts and app.ts\n      await this.generateEndpointsFile(outputDir, constructs, context);\n      const appFile = await this.generateAppFile(outputDir, context);\n\n      routes.push({\n        path: '*',\n        method: 'ALL',\n        handler: relative(process.cwd(), appFile),\n        authorizer: 'none',\n      });\n\n      logger.log(\n        `Generated server with ${constructs.length} endpoints${enableOpenApi ? ' (OpenAPI enabled)' : ''}`,\n      );\n    } else if (provider === 'aws-lambda') {\n      // For aws-lambda, create routes subdirectory\n      const routesDir = join(outputDir, 'routes');\n      await mkdir(routesDir, { recursive: true });\n\n      // Generate individual handlers for API Gateway routes\n      for (const { key, construct, path } of constructs) {\n        const handlerFile = await this.generateHandlerFile(\n          routesDir,\n          path.relative,\n          key,\n          'aws-apigatewayv2',\n          construct,\n          context,\n        );\n\n        const routeInfo: RouteInfo = {\n          path: construct._path,\n          method: construct.method,\n          handler: relative(process.cwd(), handlerFile).replace(\n            /\\.ts$/,\n            '.handler',\n          ),\n          timeout: construct.timeout,\n          memorySize: construct.memorySize,\n          environment: await construct.getEnvironment(),\n          authorizer: construct.authorizer?.name ?? 'none',\n        };\n\n        routes.push(routeInfo);\n        logger.log(\n          `Generated handler for ${routeInfo.method} ${routeInfo.path}`,\n        );\n      }\n    } else {\n      // Generate individual handler files for AWS API Gateway providers\n      for (const { key, construct, path } of constructs) {\n        const handlerFile = await this.generateHandlerFile(\n          outputDir,\n          path.relative,\n          key,\n          provider,\n          construct,\n          context,\n        );\n\n        const routeInfo: RouteInfo = {\n          path: construct._path,\n          method: construct.method,\n          handler: relative(process.cwd(), handlerFile).replace(\n            /\\.ts$/,\n            '.handler',\n          ),\n          timeout: construct.timeout,\n          memorySize: construct.memorySize,\n          environment: await construct.getEnvironment(),\n          authorizer: construct.authorizer?.name ?? 'none',\n        };\n\n        routes.push(routeInfo);\n        logger.log(\n          `Generated handler for ${routeInfo.method} ${routeInfo.path}`,\n        );\n      }\n    }\n\n    return routes;\n  }\n\n  private async generateHandlerFile(\n    outputDir: string,\n    sourceFile: string,\n    exportName: string,\n    provider: LegacyProvider,\n    _endpoint: Endpoint<\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any\n    >,\n    context: BuildContext,\n  ): Promise<string> {\n    const handlerFileName = `${exportName}.ts`;\n    const handlerPath = join(outputDir, handlerFileName);\n\n    const relativePath = relative(dirname(handlerPath), sourceFile);\n    const importPath = relativePath.replace(/\\.ts$/, '.js');\n\n    const relativeEnvParserPath = relative(\n      dirname(handlerPath),\n      context.envParserPath,\n    );\n\n    let content: string;\n\n    switch (provider) {\n      case 'aws-apigatewayv1':\n        content = this.generateAWSApiGatewayV1Handler(\n          importPath,\n          exportName,\n          relativeEnvParserPath,\n          context.envParserImportPattern,\n        );\n        break;\n      case 'aws-apigatewayv2':\n        content = this.generateAWSApiGatewayV2Handler(\n          importPath,\n          exportName,\n          relativeEnvParserPath,\n          context.envParserImportPattern,\n        );\n        break;\n      case 'server':\n        content = this.generateServerHandler(importPath, exportName);\n        break;\n      default:\n        throw new Error(`Unsupported provider: ${provider}`);\n    }\n\n    await writeFile(handlerPath, content);\n    return handlerPath;\n  }\n\n  private async generateEndpointsFile(\n    outputDir: string,\n    endpoints: GeneratedConstruct<\n      Endpoint<\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any\n      >\n    >[],\n    context: BuildContext,\n  ): Promise<string> {\n    const endpointsFileName = 'endpoints.ts';\n    const endpointsPath = join(outputDir, endpointsFileName);\n\n    // Group imports by file\n    const importsByFile = new Map<string, string[]>();\n\n    for (const { path, key } of endpoints) {\n      const relativePath = relative(dirname(endpointsPath), path.relative);\n      const importPath = relativePath.replace(/\\.ts$/, '.js');\n\n      if (!importsByFile.has(importPath)) {\n        importsByFile.set(importPath, []);\n      }\n      importsByFile.get(importPath)!.push(key);\n    }\n\n    // Generate import statements\n    const imports = Array.from(importsByFile.entries())\n      .map(\n        ([importPath, exports]) =>\n          `import { ${exports.join(', ')} } from '${importPath}';`,\n      )\n      .join('\\n');\n\n    const allExportNames = endpoints.map(({ key }) => key);\n\n    const content = `import type { EnvironmentParser } from '@geekmidas/envkit';\nimport type { Logger } from '@geekmidas/logger';\nimport { HonoEndpoint } from '@geekmidas/constructs/hono';\nimport { Endpoint } from '@geekmidas/constructs/endpoints';\nimport { ServiceDiscovery } from '@geekmidas/services';\nimport type { Hono } from 'hono';\n${imports}\n\nconst endpoints: Endpoint<any, any, any, any, any, any, any, any, any, any, any, any, any, any>[] = [\n  ${allExportNames.join(',\\n  ')}\n];\n\nexport function setupEndpoints(\n  app: Hono,\n  envParser: EnvironmentParser<any>,\n  logger: Logger,\n  enableOpenApi: boolean = true,\n): void {\n  const serviceDiscovery = ServiceDiscovery.getInstance(\n    logger,\n    envParser\n  );\n\n  // Configure OpenAPI options based on enableOpenApi flag\n  const openApiOptions: any = enableOpenApi ? {\n    docsPath: '/docs',\n    openApiOptions: {\n      title: 'API Documentation',\n      version: '1.0.0',\n      description: 'Generated API documentation'\n    }\n  } : { docsPath: false };\n\n  HonoEndpoint.addRoutes(endpoints, serviceDiscovery, app, openApiOptions);\n}\n`;\n\n    await writeFile(endpointsPath, content);\n\n    return endpointsPath;\n  }\n\n  private async generateAppFile(\n    outputDir: string,\n    context: BuildContext,\n  ): Promise<string> {\n    const appFileName = 'app.ts';\n    const appPath = join(outputDir, appFileName);\n\n    const relativeLoggerPath = relative(dirname(appPath), context.loggerPath);\n\n    const relativeEnvParserPath = relative(\n      dirname(appPath),\n      context.envParserPath,\n    );\n\n    const content = `/**\n * Generated server application\n *\n * ⚠️  WARNING: This is for LOCAL DEVELOPMENT ONLY\n * The subscriber polling mechanism is not production-ready.\n * For production, use AWS Lambda with SQS/SNS event sources.\n */\nimport { Hono } from 'hono';\nimport type { Hono as HonoType } from 'hono';\nimport { setupEndpoints } from './endpoints.js';\nimport { setupSubscribers } from './subscribers.js';\nimport ${context.envParserImportPattern} from '${relativeEnvParserPath}';\nimport ${context.loggerImportPattern} from '${relativeLoggerPath}';\n\nexport interface ServerApp {\n  app: HonoType;\n  start: (options?: {\n    port?: number;\n    serve: (app: HonoType, port: number) => void | Promise<void>;\n  }) => Promise<void>;\n}\n\n/**\n * Create and configure the Hono application\n *\n * @param app - Optional Hono app instance to configure (creates new one if not provided)\n * @param enableOpenApi - Enable OpenAPI documentation (default: true)\n * @returns Server app with configured Hono app and start function\n *\n * @example\n * // With Bun\n * import { createApp } from './.gkm/server/app.js';\n *\n * const { app, start } = createApp();\n *\n * await start({\n *   port: 3000,\n *   serve: (app, port) => {\n *     Bun.serve({ port, fetch: app.fetch });\n *   }\n * });\n *\n * @example\n * // With Node.js (using @hono/node-server)\n * import { serve } from '@hono/node-server';\n * import { createApp } from './.gkm/server/app.js';\n *\n * const { app, start } = createApp();\n *\n * await start({\n *   port: 3000,\n *   serve: (app, port) => {\n *     serve({ fetch: app.fetch, port });\n *   }\n * });\n */\nexport function createApp(app?: HonoType, enableOpenApi: boolean = true): ServerApp {\n  const honoApp = app || new Hono();\n\n  // Setup HTTP endpoints\n  setupEndpoints(honoApp, envParser, logger, enableOpenApi);\n\n  return {\n    app: honoApp,\n    async start(options) {\n      if (!options?.serve) {\n        throw new Error(\n          'serve function is required. Pass a serve function for your runtime:\\\\n' +\n          '  - Bun: (app, port) => Bun.serve({ port, fetch: app.fetch })\\\\n' +\n          '  - Node: (app, port) => serve({ fetch: app.fetch, port })'\n        );\n      }\n\n      const port = options.port ?? 3000;\n\n      // Start subscribers in background (non-blocking, local development only)\n      await setupSubscribers(envParser, logger).catch((error) => {\n        logger.error({ error }, 'Failed to start subscribers');\n      });\n\n      logger.info({ port }, 'Starting server');\n\n      // Start HTTP server using provided serve function\n      await options.serve(honoApp, port);\n\n      logger.info({ port }, 'Server started');\n    }\n  };\n}\n\n// Default export for convenience\nexport default createApp;\n`;\n\n    await writeFile(appPath, content);\n\n    return appPath;\n  }\n\n  private generateAWSApiGatewayV1Handler(\n    importPath: string,\n    exportName: string,\n    envParserPath: string,\n    envParserImportPattern: string,\n  ): string {\n    return `import { AmazonApiGatewayV1Endpoint } from '@geekmidas/constructs/aws';\nimport { ${exportName} } from '${importPath}';\nimport ${envParserImportPattern} from '${envParserPath}';\n\nconst adapter = new AmazonApiGatewayV1Endpoint(envParser, ${exportName});\n\nexport const handler = adapter.handler;\n`;\n  }\n\n  private generateAWSApiGatewayV2Handler(\n    importPath: string,\n    exportName: string,\n    envParserPath: string,\n    envParserImportPattern: string,\n  ): string {\n    return `import { AmazonApiGatewayV2Endpoint } from '@geekmidas/constructs/aws';\nimport { ${exportName} } from '${importPath}';\nimport ${envParserImportPattern} from '${envParserPath}';\n\nconst adapter = new AmazonApiGatewayV2Endpoint(envParser, ${exportName});\n\nexport const handler = adapter.handler;\n`;\n  }\n\n  private generateServerHandler(\n    importPath: string,\n    exportName: string,\n  ): string {\n    return `import { ${exportName} } from '${importPath}';\n\n// Server handler - implement based on your server framework\nexport const handler = ${exportName};\n`;\n  }\n}\n"],"mappings":"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"}