@geekmidas/cli 0.5.0 → 0.5.1

package/dist/index.cjs

@@ -32,7 +32,7 @@ const commander = require_chunk.__toESM(require("commander"));
 
 //#region package.json
 var name = "@geekmidas/cli";
-var version = "0.5.0";
+var version = "0.5.1";
 var description = "CLI tools for building Lambda handlers, server applications, and generating OpenAPI specs";
 var private$1 = false;
 var type = "module";

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["Command","pkg","name: string | undefined","options: InitOptions","name","options: {\n      provider?: string;\n      providers?: string;\n      enableOpenapi?: boolean;\n    }","options: { port?: string; enableOpenapi?: boolean }","options: { output?: string; json?: boolean }","options: { input?: string; output?: string; name?: string }"],"sources":["../package.json","../src/index.ts"],"sourcesContent":["{\n  \"name\": \"@geekmidas/cli\",\n  \"version\": \"0.5.0\",\n  \"description\": \"CLI tools for building Lambda handlers, server applications, and generating OpenAPI specs\",\n  \"private\": false,\n  \"type\": \"module\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.mjs\",\n      \"require\": \"./dist/index.cjs\"\n    },\n    \"./config\": {\n      \"types\": \"./dist/config.d.ts\",\n      \"import\": \"./dist/config.mjs\",\n      \"require\": \"./dist/config.cjs\"\n    },\n    \"./openapi\": {\n      \"types\": \"./dist/openapi.d.ts\",\n      \"import\": \"./dist/openapi.mjs\",\n      \"require\": \"./dist/openapi.cjs\"\n    },\n    \"./openapi-react-query\": {\n      \"types\": \"./dist/openapi-react-query.d.ts\",\n      \"import\": \"./dist/openapi-react-query.mjs\",\n      \"require\": \"./dist/openapi-react-query.cjs\"\n    }\n  },\n  \"bin\": {\n    \"gkm\": \"./dist/index.cjs\"\n  },\n  \"scripts\": {\n    \"ts\": \"tsc --noEmit --skipLibCheck src/**/*.ts\",\n    \"test\": \"vitest\",\n    \"test:once\": \"vitest run\",\n    \"test:coverage\": \"vitest run --coverage\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/geekmidas/toolbox\"\n  },\n  \"dependencies\": {\n    \"@apidevtools/swagger-parser\": \"^10.1.0\",\n    \"chokidar\": \"~4.0.3\",\n    \"commander\": \"^12.1.0\",\n    \"dotenv\": \"~17.2.3\",\n    \"fast-glob\": \"^3.3.2\",\n    \"lodash.kebabcase\": \"^4.1.1\",\n    \"openapi-typescript\": \"^7.4.2\",\n    \"prompts\": \"~2.4.2\"\n  },\n  \"devDependencies\": {\n    \"@geekmidas/testkit\": \"workspace:*\",\n    \"@types/lodash.kebabcase\": \"^4.1.9\",\n    \"@types/node\": \"~24.9.1\",\n    \"@types/prompts\": \"~2.4.9\",\n    \"typescript\": \"^5.8.2\",\n    \"vitest\": \"^3.2.4\",\n    \"zod\": \"~4.1.13\"\n  },\n  \"peerDependencies\": {\n    \"@geekmidas/constructs\": \"workspace:~\",\n    \"@geekmidas/envkit\": \"workspace:~\",\n    \"@geekmidas/logger\": \"workspace:~\",\n    \"@geekmidas/schema\": \"workspace:~\",\n    \"@geekmidas/telescope\": \"workspace:~\"\n  },\n  \"peerDependenciesMeta\": {\n    \"@geekmidas/telescope\": {\n      \"optional\": true\n    }\n  }\n}\n","#!/usr/bin/env -S npx tsx\n\nimport { Command } from 'commander';\nimport pkg from '../package.json' assert { type: 'json' };\nimport { buildCommand } from './build/index.ts';\nimport { devCommand } from './dev/index.ts';\nimport { type InitOptions, initCommand } from './init/index.ts';\nimport { generateReactQueryCommand } from './openapi-react-query.ts';\nimport { openapiCommand } from './openapi.ts';\nimport type { LegacyProvider, MainProvider } from './types.ts';\n\nconst program = new Command();\n\nprogram\n  .name('gkm')\n  .description('GeekMidas backend framework CLI')\n  .version(pkg.version)\n  .option('--cwd <path>', 'Change working directory');\n\nprogram\n  .command('init')\n  .description('Scaffold a new project')\n  .argument('[name]', 'Project name')\n  .option(\n    '--template <template>',\n    'Project template (minimal, api, serverless, worker)',\n  )\n  .option('--skip-install', 'Skip dependency installation', false)\n  .option('-y, --yes', 'Skip prompts, use defaults', false)\n  .option('--monorepo', 'Setup as monorepo with packages/models', false)\n  .option('--api-path <path>', 'API app path in monorepo (default: apps/api)')\n  .action(async (name: string | undefined, options: InitOptions) => {\n    try {\n      const globalOptions = program.opts();\n      if (globalOptions.cwd) {\n        process.chdir(globalOptions.cwd);\n      }\n      await initCommand(name, options);\n    } catch (error) {\n      console.error('Init failed:', (error as Error).message);\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('build')\n  .description('Build handlers from endpoints, functions, and crons')\n  .option(\n    '--provider <provider>',\n    'Target provider for generated handlers (aws, server)',\n  )\n  .option(\n    '--providers <providers>',\n    '[DEPRECATED] Use --provider instead. Target providers for generated handlers (comma-separated)',\n  )\n  .option(\n    '--enable-openapi',\n    'Enable OpenAPI documentation generation for server builds',\n  )\n  .action(\n    async (options: {\n      provider?: string;\n      providers?: string;\n      enableOpenapi?: boolean;\n    }) => {\n      try {\n        const globalOptions = program.opts();\n        if (globalOptions.cwd) {\n          process.chdir(globalOptions.cwd);\n        }\n\n        // Handle new single provider option\n        if (options.provider) {\n          if (!['aws', 'server'].includes(options.provider)) {\n            console.error(\n              `Invalid provider: ${options.provider}. Must be 'aws' or 'server'.`,\n            );\n            process.exit(1);\n          }\n          await buildCommand({\n            provider: options.provider as MainProvider,\n            enableOpenApi: options.enableOpenapi || false,\n          });\n        }\n        // Handle legacy providers option\n        else if (options.providers) {\n          console.warn(\n            '⚠️  --providers flag is deprecated. Use --provider instead.',\n          );\n          const providerList = [\n            ...new Set(options.providers.split(',').map((p) => p.trim())),\n          ] as LegacyProvider[];\n          await buildCommand({\n            providers: providerList,\n            enableOpenApi: options.enableOpenapi || false,\n          });\n        }\n        // Default to config-driven build\n        else {\n          await buildCommand({\n            enableOpenApi: options.enableOpenapi || false,\n          });\n        }\n      } catch (error) {\n        console.error('Build failed:', (error as Error).message);\n        process.exit(1);\n      }\n    },\n  );\n\nprogram\n  .command('dev')\n  .description('Start development server with automatic reload')\n  .option('--port <port>', 'Port to run the development server on', '3000')\n  .option(\n    '--enable-openapi',\n    'Enable OpenAPI documentation for development server',\n    true,\n  )\n  .action(async (options: { port?: string; enableOpenapi?: boolean }) => {\n    try {\n      const globalOptions = program.opts();\n      if (globalOptions.cwd) {\n        process.chdir(globalOptions.cwd);\n      }\n\n      await devCommand({\n        port: options.port ? Number.parseInt(options.port) : 3000,\n        enableOpenApi: options.enableOpenapi ?? true,\n      });\n    } catch (error) {\n      console.error('Dev server failed:', (error as Error).message);\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('cron')\n  .description('Manage cron jobs')\n  .action(() => {\n    const globalOptions = program.opts();\n    if (globalOptions.cwd) {\n      process.chdir(globalOptions.cwd);\n    }\n    process.stdout.write('Cron management - coming soon\\n');\n  });\n\nprogram\n  .command('function')\n  .description('Manage serverless functions')\n  .action(() => {\n    const globalOptions = program.opts();\n    if (globalOptions.cwd) {\n      process.chdir(globalOptions.cwd);\n    }\n    process.stdout.write('Serverless function management - coming soon\\n');\n  });\n\nprogram\n  .command('api')\n  .description('Manage REST API endpoints')\n  .action(() => {\n    const globalOptions = program.opts();\n    if (globalOptions.cwd) {\n      process.chdir(globalOptions.cwd);\n    }\n    process.stdout.write('REST API management - coming soon\\n');\n  });\n\nprogram\n  .command('openapi')\n  .description(\n    'Generate OpenAPI specification from endpoints (TypeScript by default)',\n  )\n  .option(\n    '--output <path>',\n    'Output file path for the OpenAPI spec',\n    'openapi.ts',\n  )\n  .option('--json', 'Generate JSON instead of TypeScript (legacy)', false)\n  .action(async (options: { output?: string; json?: boolean }) => {\n    try {\n      const globalOptions = program.opts();\n      if (globalOptions.cwd) {\n        process.chdir(globalOptions.cwd);\n      }\n      await openapiCommand(options);\n    } catch (error) {\n      console.error('OpenAPI generation failed:', (error as Error).message);\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('generate:react-query')\n  .description('Generate React Query hooks from OpenAPI specification')\n  .option('--input <path>', 'Input OpenAPI spec file path', 'openapi.json')\n  .option(\n    '--output <path>',\n    'Output file path for generated hooks',\n    'src/api/hooks.ts',\n  )\n  .option('--name <name>', 'API name prefix for generated code', 'API')\n  .action(\n    async (options: { input?: string; output?: string; name?: string }) => {\n      try {\n        const globalOptions = program.opts();\n        if (globalOptions.cwd) {\n          process.chdir(globalOptions.cwd);\n        }\n        await generateReactQueryCommand(options);\n      } catch (error) {\n        console.error(\n          'React Query generation failed:',\n          (error as Error).message,\n        );\n        process.exit(1);\n      }\n    },\n  );\n\nprogram.parse();\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["Command","pkg","name: string | undefined","options: InitOptions","name","options: {\n      provider?: string;\n      providers?: string;\n      enableOpenapi?: boolean;\n    }","options: { port?: string; enableOpenapi?: boolean }","options: { output?: string; json?: boolean }","options: { input?: string; output?: string; name?: string }"],"sources":["../package.json","../src/index.ts"],"sourcesContent":["{\n  \"name\": \"@geekmidas/cli\",\n  \"version\": \"0.5.1\",\n  \"description\": \"CLI tools for building Lambda handlers, server applications, and generating OpenAPI specs\",\n  \"private\": false,\n  \"type\": \"module\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.mjs\",\n      \"require\": \"./dist/index.cjs\"\n    },\n    \"./config\": {\n      \"types\": \"./dist/config.d.ts\",\n      \"import\": \"./dist/config.mjs\",\n      \"require\": \"./dist/config.cjs\"\n    },\n    \"./openapi\": {\n      \"types\": \"./dist/openapi.d.ts\",\n      \"import\": \"./dist/openapi.mjs\",\n      \"require\": \"./dist/openapi.cjs\"\n    },\n    \"./openapi-react-query\": {\n      \"types\": \"./dist/openapi-react-query.d.ts\",\n      \"import\": \"./dist/openapi-react-query.mjs\",\n      \"require\": \"./dist/openapi-react-query.cjs\"\n    }\n  },\n  \"bin\": {\n    \"gkm\": \"./dist/index.cjs\"\n  },\n  \"scripts\": {\n    \"ts\": \"tsc --noEmit --skipLibCheck src/**/*.ts\",\n    \"test\": \"vitest\",\n    \"test:once\": \"vitest run\",\n    \"test:coverage\": \"vitest run --coverage\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/geekmidas/toolbox\"\n  },\n  \"dependencies\": {\n    \"@apidevtools/swagger-parser\": \"^10.1.0\",\n    \"chokidar\": \"~4.0.3\",\n    \"commander\": \"^12.1.0\",\n    \"dotenv\": \"~17.2.3\",\n    \"fast-glob\": \"^3.3.2\",\n    \"lodash.kebabcase\": \"^4.1.1\",\n    \"openapi-typescript\": \"^7.4.2\",\n    \"prompts\": \"~2.4.2\"\n  },\n  \"devDependencies\": {\n    \"@geekmidas/testkit\": \"workspace:*\",\n    \"@types/lodash.kebabcase\": \"^4.1.9\",\n    \"@types/node\": \"~24.9.1\",\n    \"@types/prompts\": \"~2.4.9\",\n    \"typescript\": \"^5.8.2\",\n    \"vitest\": \"^3.2.4\",\n    \"zod\": \"~4.1.13\"\n  },\n  \"peerDependencies\": {\n    \"@geekmidas/constructs\": \"workspace:~\",\n    \"@geekmidas/envkit\": \"workspace:~\",\n    \"@geekmidas/logger\": \"workspace:~\",\n    \"@geekmidas/schema\": \"workspace:~\",\n    \"@geekmidas/telescope\": \"workspace:~\"\n  },\n  \"peerDependenciesMeta\": {\n    \"@geekmidas/telescope\": {\n      \"optional\": true\n    }\n  }\n}\n","#!/usr/bin/env -S npx tsx\n\nimport { Command } from 'commander';\nimport pkg from '../package.json' assert { type: 'json' };\nimport { buildCommand } from './build/index.ts';\nimport { devCommand } from './dev/index.ts';\nimport { type InitOptions, initCommand } from './init/index.ts';\nimport { generateReactQueryCommand } from './openapi-react-query.ts';\nimport { openapiCommand } from './openapi.ts';\nimport type { LegacyProvider, MainProvider } from './types.ts';\n\nconst program = new Command();\n\nprogram\n  .name('gkm')\n  .description('GeekMidas backend framework CLI')\n  .version(pkg.version)\n  .option('--cwd <path>', 'Change working directory');\n\nprogram\n  .command('init')\n  .description('Scaffold a new project')\n  .argument('[name]', 'Project name')\n  .option(\n    '--template <template>',\n    'Project template (minimal, api, serverless, worker)',\n  )\n  .option('--skip-install', 'Skip dependency installation', false)\n  .option('-y, --yes', 'Skip prompts, use defaults', false)\n  .option('--monorepo', 'Setup as monorepo with packages/models', false)\n  .option('--api-path <path>', 'API app path in monorepo (default: apps/api)')\n  .action(async (name: string | undefined, options: InitOptions) => {\n    try {\n      const globalOptions = program.opts();\n      if (globalOptions.cwd) {\n        process.chdir(globalOptions.cwd);\n      }\n      await initCommand(name, options);\n    } catch (error) {\n      console.error('Init failed:', (error as Error).message);\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('build')\n  .description('Build handlers from endpoints, functions, and crons')\n  .option(\n    '--provider <provider>',\n    'Target provider for generated handlers (aws, server)',\n  )\n  .option(\n    '--providers <providers>',\n    '[DEPRECATED] Use --provider instead. Target providers for generated handlers (comma-separated)',\n  )\n  .option(\n    '--enable-openapi',\n    'Enable OpenAPI documentation generation for server builds',\n  )\n  .action(\n    async (options: {\n      provider?: string;\n      providers?: string;\n      enableOpenapi?: boolean;\n    }) => {\n      try {\n        const globalOptions = program.opts();\n        if (globalOptions.cwd) {\n          process.chdir(globalOptions.cwd);\n        }\n\n        // Handle new single provider option\n        if (options.provider) {\n          if (!['aws', 'server'].includes(options.provider)) {\n            console.error(\n              `Invalid provider: ${options.provider}. Must be 'aws' or 'server'.`,\n            );\n            process.exit(1);\n          }\n          await buildCommand({\n            provider: options.provider as MainProvider,\n            enableOpenApi: options.enableOpenapi || false,\n          });\n        }\n        // Handle legacy providers option\n        else if (options.providers) {\n          console.warn(\n            '⚠️  --providers flag is deprecated. Use --provider instead.',\n          );\n          const providerList = [\n            ...new Set(options.providers.split(',').map((p) => p.trim())),\n          ] as LegacyProvider[];\n          await buildCommand({\n            providers: providerList,\n            enableOpenApi: options.enableOpenapi || false,\n          });\n        }\n        // Default to config-driven build\n        else {\n          await buildCommand({\n            enableOpenApi: options.enableOpenapi || false,\n          });\n        }\n      } catch (error) {\n        console.error('Build failed:', (error as Error).message);\n        process.exit(1);\n      }\n    },\n  );\n\nprogram\n  .command('dev')\n  .description('Start development server with automatic reload')\n  .option('--port <port>', 'Port to run the development server on', '3000')\n  .option(\n    '--enable-openapi',\n    'Enable OpenAPI documentation for development server',\n    true,\n  )\n  .action(async (options: { port?: string; enableOpenapi?: boolean }) => {\n    try {\n      const globalOptions = program.opts();\n      if (globalOptions.cwd) {\n        process.chdir(globalOptions.cwd);\n      }\n\n      await devCommand({\n        port: options.port ? Number.parseInt(options.port) : 3000,\n        enableOpenApi: options.enableOpenapi ?? true,\n      });\n    } catch (error) {\n      console.error('Dev server failed:', (error as Error).message);\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('cron')\n  .description('Manage cron jobs')\n  .action(() => {\n    const globalOptions = program.opts();\n    if (globalOptions.cwd) {\n      process.chdir(globalOptions.cwd);\n    }\n    process.stdout.write('Cron management - coming soon\\n');\n  });\n\nprogram\n  .command('function')\n  .description('Manage serverless functions')\n  .action(() => {\n    const globalOptions = program.opts();\n    if (globalOptions.cwd) {\n      process.chdir(globalOptions.cwd);\n    }\n    process.stdout.write('Serverless function management - coming soon\\n');\n  });\n\nprogram\n  .command('api')\n  .description('Manage REST API endpoints')\n  .action(() => {\n    const globalOptions = program.opts();\n    if (globalOptions.cwd) {\n      process.chdir(globalOptions.cwd);\n    }\n    process.stdout.write('REST API management - coming soon\\n');\n  });\n\nprogram\n  .command('openapi')\n  .description(\n    'Generate OpenAPI specification from endpoints (TypeScript by default)',\n  )\n  .option(\n    '--output <path>',\n    'Output file path for the OpenAPI spec',\n    'openapi.ts',\n  )\n  .option('--json', 'Generate JSON instead of TypeScript (legacy)', false)\n  .action(async (options: { output?: string; json?: boolean }) => {\n    try {\n      const globalOptions = program.opts();\n      if (globalOptions.cwd) {\n        process.chdir(globalOptions.cwd);\n      }\n      await openapiCommand(options);\n    } catch (error) {\n      console.error('OpenAPI generation failed:', (error as Error).message);\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('generate:react-query')\n  .description('Generate React Query hooks from OpenAPI specification')\n  .option('--input <path>', 'Input OpenAPI spec file path', 'openapi.json')\n  .option(\n    '--output <path>',\n    'Output file path for generated hooks',\n    'src/api/hooks.ts',\n  )\n  .option('--name <name>', 'API name prefix for generated code', 'API')\n  .action(\n    async (options: { input?: string; output?: string; name?: string }) => {\n      try {\n        const globalOptions = program.opts();\n        if (globalOptions.cwd) {\n          process.chdir(globalOptions.cwd);\n        }\n        await generateReactQueryCommand(options);\n      } catch (error) {\n        console.error(\n          'React Query generation failed:',\n          (error as Error).message,\n        );\n        process.exit(1);\n      }\n    },\n  );\n\nprogram.parse();\n"],"mappings":"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"}

package/dist/index.mjs

@@ -31,7 +31,7 @@ import { Command } from "commander";
 
 //#region package.json
 var name = "@geekmidas/cli";
-var version = "0.5.0";
+var version = "0.5.1";
 var description = "CLI tools for building Lambda handlers, server applications, and generating OpenAPI specs";
 var private$1 = false;
 var type = "module";

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["pkg","name: string | undefined","options: InitOptions","name","options: {\n      provider?: string;\n      providers?: string;\n      enableOpenapi?: boolean;\n    }","options: { port?: string; enableOpenapi?: boolean }","options: { output?: string; json?: boolean }","options: { input?: string; output?: string; name?: string }"],"sources":["../package.json","../src/index.ts"],"sourcesContent":["{\n  \"name\": \"@geekmidas/cli\",\n  \"version\": \"0.5.0\",\n  \"description\": \"CLI tools for building Lambda handlers, server applications, and generating OpenAPI specs\",\n  \"private\": false,\n  \"type\": \"module\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.mjs\",\n      \"require\": \"./dist/index.cjs\"\n    },\n    \"./config\": {\n      \"types\": \"./dist/config.d.ts\",\n      \"import\": \"./dist/config.mjs\",\n      \"require\": \"./dist/config.cjs\"\n    },\n    \"./openapi\": {\n      \"types\": \"./dist/openapi.d.ts\",\n      \"import\": \"./dist/openapi.mjs\",\n      \"require\": \"./dist/openapi.cjs\"\n    },\n    \"./openapi-react-query\": {\n      \"types\": \"./dist/openapi-react-query.d.ts\",\n      \"import\": \"./dist/openapi-react-query.mjs\",\n      \"require\": \"./dist/openapi-react-query.cjs\"\n    }\n  },\n  \"bin\": {\n    \"gkm\": \"./dist/index.cjs\"\n  },\n  \"scripts\": {\n    \"ts\": \"tsc --noEmit --skipLibCheck src/**/*.ts\",\n    \"test\": \"vitest\",\n    \"test:once\": \"vitest run\",\n    \"test:coverage\": \"vitest run --coverage\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/geekmidas/toolbox\"\n  },\n  \"dependencies\": {\n    \"@apidevtools/swagger-parser\": \"^10.1.0\",\n    \"chokidar\": \"~4.0.3\",\n    \"commander\": \"^12.1.0\",\n    \"dotenv\": \"~17.2.3\",\n    \"fast-glob\": \"^3.3.2\",\n    \"lodash.kebabcase\": \"^4.1.1\",\n    \"openapi-typescript\": \"^7.4.2\",\n    \"prompts\": \"~2.4.2\"\n  },\n  \"devDependencies\": {\n    \"@geekmidas/testkit\": \"workspace:*\",\n    \"@types/lodash.kebabcase\": \"^4.1.9\",\n    \"@types/node\": \"~24.9.1\",\n    \"@types/prompts\": \"~2.4.9\",\n    \"typescript\": \"^5.8.2\",\n    \"vitest\": \"^3.2.4\",\n    \"zod\": \"~4.1.13\"\n  },\n  \"peerDependencies\": {\n    \"@geekmidas/constructs\": \"workspace:~\",\n    \"@geekmidas/envkit\": \"workspace:~\",\n    \"@geekmidas/logger\": \"workspace:~\",\n    \"@geekmidas/schema\": \"workspace:~\",\n    \"@geekmidas/telescope\": \"workspace:~\"\n  },\n  \"peerDependenciesMeta\": {\n    \"@geekmidas/telescope\": {\n      \"optional\": true\n    }\n  }\n}\n","#!/usr/bin/env -S npx tsx\n\nimport { Command } from 'commander';\nimport pkg from '../package.json' assert { type: 'json' };\nimport { buildCommand } from './build/index.ts';\nimport { devCommand } from './dev/index.ts';\nimport { type InitOptions, initCommand } from './init/index.ts';\nimport { generateReactQueryCommand } from './openapi-react-query.ts';\nimport { openapiCommand } from './openapi.ts';\nimport type { LegacyProvider, MainProvider } from './types.ts';\n\nconst program = new Command();\n\nprogram\n  .name('gkm')\n  .description('GeekMidas backend framework CLI')\n  .version(pkg.version)\n  .option('--cwd <path>', 'Change working directory');\n\nprogram\n  .command('init')\n  .description('Scaffold a new project')\n  .argument('[name]', 'Project name')\n  .option(\n    '--template <template>',\n    'Project template (minimal, api, serverless, worker)',\n  )\n  .option('--skip-install', 'Skip dependency installation', false)\n  .option('-y, --yes', 'Skip prompts, use defaults', false)\n  .option('--monorepo', 'Setup as monorepo with packages/models', false)\n  .option('--api-path <path>', 'API app path in monorepo (default: apps/api)')\n  .action(async (name: string | undefined, options: InitOptions) => {\n    try {\n      const globalOptions = program.opts();\n      if (globalOptions.cwd) {\n        process.chdir(globalOptions.cwd);\n      }\n      await initCommand(name, options);\n    } catch (error) {\n      console.error('Init failed:', (error as Error).message);\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('build')\n  .description('Build handlers from endpoints, functions, and crons')\n  .option(\n    '--provider <provider>',\n    'Target provider for generated handlers (aws, server)',\n  )\n  .option(\n    '--providers <providers>',\n    '[DEPRECATED] Use --provider instead. Target providers for generated handlers (comma-separated)',\n  )\n  .option(\n    '--enable-openapi',\n    'Enable OpenAPI documentation generation for server builds',\n  )\n  .action(\n    async (options: {\n      provider?: string;\n      providers?: string;\n      enableOpenapi?: boolean;\n    }) => {\n      try {\n        const globalOptions = program.opts();\n        if (globalOptions.cwd) {\n          process.chdir(globalOptions.cwd);\n        }\n\n        // Handle new single provider option\n        if (options.provider) {\n          if (!['aws', 'server'].includes(options.provider)) {\n            console.error(\n              `Invalid provider: ${options.provider}. Must be 'aws' or 'server'.`,\n            );\n            process.exit(1);\n          }\n          await buildCommand({\n            provider: options.provider as MainProvider,\n            enableOpenApi: options.enableOpenapi || false,\n          });\n        }\n        // Handle legacy providers option\n        else if (options.providers) {\n          console.warn(\n            '⚠️  --providers flag is deprecated. Use --provider instead.',\n          );\n          const providerList = [\n            ...new Set(options.providers.split(',').map((p) => p.trim())),\n          ] as LegacyProvider[];\n          await buildCommand({\n            providers: providerList,\n            enableOpenApi: options.enableOpenapi || false,\n          });\n        }\n        // Default to config-driven build\n        else {\n          await buildCommand({\n            enableOpenApi: options.enableOpenapi || false,\n          });\n        }\n      } catch (error) {\n        console.error('Build failed:', (error as Error).message);\n        process.exit(1);\n      }\n    },\n  );\n\nprogram\n  .command('dev')\n  .description('Start development server with automatic reload')\n  .option('--port <port>', 'Port to run the development server on', '3000')\n  .option(\n    '--enable-openapi',\n    'Enable OpenAPI documentation for development server',\n    true,\n  )\n  .action(async (options: { port?: string; enableOpenapi?: boolean }) => {\n    try {\n      const globalOptions = program.opts();\n      if (globalOptions.cwd) {\n        process.chdir(globalOptions.cwd);\n      }\n\n      await devCommand({\n        port: options.port ? Number.parseInt(options.port) : 3000,\n        enableOpenApi: options.enableOpenapi ?? true,\n      });\n    } catch (error) {\n      console.error('Dev server failed:', (error as Error).message);\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('cron')\n  .description('Manage cron jobs')\n  .action(() => {\n    const globalOptions = program.opts();\n    if (globalOptions.cwd) {\n      process.chdir(globalOptions.cwd);\n    }\n    process.stdout.write('Cron management - coming soon\\n');\n  });\n\nprogram\n  .command('function')\n  .description('Manage serverless functions')\n  .action(() => {\n    const globalOptions = program.opts();\n    if (globalOptions.cwd) {\n      process.chdir(globalOptions.cwd);\n    }\n    process.stdout.write('Serverless function management - coming soon\\n');\n  });\n\nprogram\n  .command('api')\n  .description('Manage REST API endpoints')\n  .action(() => {\n    const globalOptions = program.opts();\n    if (globalOptions.cwd) {\n      process.chdir(globalOptions.cwd);\n    }\n    process.stdout.write('REST API management - coming soon\\n');\n  });\n\nprogram\n  .command('openapi')\n  .description(\n    'Generate OpenAPI specification from endpoints (TypeScript by default)',\n  )\n  .option(\n    '--output <path>',\n    'Output file path for the OpenAPI spec',\n    'openapi.ts',\n  )\n  .option('--json', 'Generate JSON instead of TypeScript (legacy)', false)\n  .action(async (options: { output?: string; json?: boolean }) => {\n    try {\n      const globalOptions = program.opts();\n      if (globalOptions.cwd) {\n        process.chdir(globalOptions.cwd);\n      }\n      await openapiCommand(options);\n    } catch (error) {\n      console.error('OpenAPI generation failed:', (error as Error).message);\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('generate:react-query')\n  .description('Generate React Query hooks from OpenAPI specification')\n  .option('--input <path>', 'Input OpenAPI spec file path', 'openapi.json')\n  .option(\n    '--output <path>',\n    'Output file path for generated hooks',\n    'src/api/hooks.ts',\n  )\n  .option('--name <name>', 'API name prefix for generated code', 'API')\n  .action(\n    async (options: { input?: string; output?: string; name?: string }) => {\n      try {\n        const globalOptions = program.opts();\n        if (globalOptions.cwd) {\n          process.chdir(globalOptions.cwd);\n        }\n        await generateReactQueryCommand(options);\n      } catch (error) {\n        console.error(\n          'React Query generation failed:',\n          (error as Error).message,\n        );\n        process.exit(1);\n      }\n    },\n  );\n\nprogram.parse();\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WACU;cACG;kBACI;gBACJ;WACH;cACG;CACT,KAAK;EACH,SAAS;EACT,UAAU;EACV,WAAW;CACZ;CACD,YAAY;EACV,SAAS;EACT,UAAU;EACV,WAAW;CACZ;CACD,aAAa;EACX,SAAS;EACT,UAAU;EACV,WAAW;CACZ;CACD,yBAAyB;EACvB,SAAS;EACT,UAAU;EACV,WAAW;CACZ;AACF;UACM,EACL,OAAO,mBACR;cACU;CACT,MAAM;CACN,QAAQ;CACR,aAAa;CACb,iBAAiB;AAClB;iBACa;CACZ,QAAQ;CACR,OAAO;AACR;mBACe;CACd,+BAA+B;CAC/B,YAAY;CACZ,aAAa;CACb,UAAU;CACV,aAAa;CACb,oBAAoB;CACpB,sBAAsB;CACtB,WAAW;AACZ;sBACkB;CACjB,sBAAsB;CACtB,2BAA2B;CAC3B,eAAe;CACf,kBAAkB;CAClB,cAAc;CACd,UAAU;CACV,OAAO;AACR;uBACmB;CAClB,yBAAyB;CACzB,qBAAqB;CACrB,qBAAqB;CACrB,qBAAqB;CACrB,wBAAwB;AACzB;2BACuB,EACtB,wBAAwB,EACtB,YAAY,KACb,EACF;sBAvEH;;;;;;;;;;;;;;AAwEC;;;;AC7DD,MAAM,UAAU,IAAI;AAEpB,QACG,KAAK,MAAM,CACX,YAAY,kCAAkC,CAC9C,QAAQA,gBAAI,QAAQ,CACpB,OAAO,gBAAgB,2BAA2B;AAErD,QACG,QAAQ,OAAO,CACf,YAAY,yBAAyB,CACrC,SAAS,UAAU,eAAe,CAClC,OACC,yBACA,sDACD,CACA,OAAO,kBAAkB,gCAAgC,MAAM,CAC/D,OAAO,aAAa,8BAA8B,MAAM,CACxD,OAAO,cAAc,0CAA0C,MAAM,CACrE,OAAO,qBAAqB,+CAA+C,CAC3E,OAAO,OAAOC,QAA0BC,YAAyB;AAChE,KAAI;EACF,MAAM,gBAAgB,QAAQ,MAAM;AACpC,MAAI,cAAc,IAChB,SAAQ,MAAM,cAAc,IAAI;AAElC,QAAM,YAAYC,QAAM,QAAQ;CACjC,SAAQ,OAAO;AACd,UAAQ,MAAM,gBAAiB,MAAgB,QAAQ;AACvD,UAAQ,KAAK,EAAE;CAChB;AACF,EAAC;AAEJ,QACG,QAAQ,QAAQ,CAChB,YAAY,sDAAsD,CAClE,OACC,yBACA,uDACD,CACA,OACC,2BACA,iGACD,CACA,OACC,oBACA,4DACD,CACA,OACC,OAAOC,YAID;AACJ,KAAI;EACF,MAAM,gBAAgB,QAAQ,MAAM;AACpC,MAAI,cAAc,IAChB,SAAQ,MAAM,cAAc,IAAI;AAIlC,MAAI,QAAQ,UAAU;AACpB,QAAK,CAAC,OAAO,QAAS,EAAC,SAAS,QAAQ,SAAS,EAAE;AACjD,YAAQ,OACL,oBAAoB,QAAQ,SAAS,8BACvC;AACD,YAAQ,KAAK,EAAE;GAChB;AACD,SAAM,aAAa;IACjB,UAAU,QAAQ;IAClB,eAAe,QAAQ,iBAAiB;GACzC,EAAC;EACH,WAEQ,QAAQ,WAAW;AAC1B,WAAQ,KACN,8DACD;GACD,MAAM,eAAe,CACnB,GAAG,IAAI,IAAI,QAAQ,UAAU,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAC7D;AACD,SAAM,aAAa;IACjB,WAAW;IACX,eAAe,QAAQ,iBAAiB;GACzC,EAAC;EACH,MAGC,OAAM,aAAa,EACjB,eAAe,QAAQ,iBAAiB,MACzC,EAAC;CAEL,SAAQ,OAAO;AACd,UAAQ,MAAM,iBAAkB,MAAgB,QAAQ;AACxD,UAAQ,KAAK,EAAE;CAChB;AACF,EACF;AAEH,QACG,QAAQ,MAAM,CACd,YAAY,iDAAiD,CAC7D,OAAO,iBAAiB,yCAAyC,OAAO,CACxE,OACC,oBACA,uDACA,KACD,CACA,OAAO,OAAOC,YAAwD;AACrE,KAAI;EACF,MAAM,gBAAgB,QAAQ,MAAM;AACpC,MAAI,cAAc,IAChB,SAAQ,MAAM,cAAc,IAAI;AAGlC,QAAM,WAAW;GACf,MAAM,QAAQ,OAAO,OAAO,SAAS,QAAQ,KAAK,GAAG;GACrD,eAAe,QAAQ,iBAAiB;EACzC,EAAC;CACH,SAAQ,OAAO;AACd,UAAQ,MAAM,sBAAuB,MAAgB,QAAQ;AAC7D,UAAQ,KAAK,EAAE;CAChB;AACF,EAAC;AAEJ,QACG,QAAQ,OAAO,CACf,YAAY,mBAAmB,CAC/B,OAAO,MAAM;CACZ,MAAM,gBAAgB,QAAQ,MAAM;AACpC,KAAI,cAAc,IAChB,SAAQ,MAAM,cAAc,IAAI;AAElC,SAAQ,OAAO,MAAM,kCAAkC;AACxD,EAAC;AAEJ,QACG,QAAQ,WAAW,CACnB,YAAY,8BAA8B,CAC1C,OAAO,MAAM;CACZ,MAAM,gBAAgB,QAAQ,MAAM;AACpC,KAAI,cAAc,IAChB,SAAQ,MAAM,cAAc,IAAI;AAElC,SAAQ,OAAO,MAAM,iDAAiD;AACvE,EAAC;AAEJ,QACG,QAAQ,MAAM,CACd,YAAY,4BAA4B,CACxC,OAAO,MAAM;CACZ,MAAM,gBAAgB,QAAQ,MAAM;AACpC,KAAI,cAAc,IAChB,SAAQ,MAAM,cAAc,IAAI;AAElC,SAAQ,OAAO,MAAM,sCAAsC;AAC5D,EAAC;AAEJ,QACG,QAAQ,UAAU,CAClB,YACC,wEACD,CACA,OACC,mBACA,yCACA,aACD,CACA,OAAO,UAAU,gDAAgD,MAAM,CACvE,OAAO,OAAOC,YAAiD;AAC9D,KAAI;EACF,MAAM,gBAAgB,QAAQ,MAAM;AACpC,MAAI,cAAc,IAChB,SAAQ,MAAM,cAAc,IAAI;AAElC,QAAM,eAAe,QAAQ;CAC9B,SAAQ,OAAO;AACd,UAAQ,MAAM,8BAA+B,MAAgB,QAAQ;AACrE,UAAQ,KAAK,EAAE;CAChB;AACF,EAAC;AAEJ,QACG,QAAQ,uBAAuB,CAC/B,YAAY,wDAAwD,CACpE,OAAO,kBAAkB,gCAAgC,eAAe,CACxE,OACC,mBACA,wCACA,mBACD,CACA,OAAO,iBAAiB,sCAAsC,MAAM,CACpE,OACC,OAAOC,YAAgE;AACrE,KAAI;EACF,MAAM,gBAAgB,QAAQ,MAAM;AACpC,MAAI,cAAc,IAChB,SAAQ,MAAM,cAAc,IAAI;AAElC,QAAM,0BAA0B,QAAQ;CACzC,SAAQ,OAAO;AACd,UAAQ,MACN,kCACC,MAAgB,QAClB;AACD,UAAQ,KAAK,EAAE;CAChB;AACF,EACF;AAEH,QAAQ,OAAO"}
+{"version":3,"file":"index.mjs","names":["pkg","name: string | undefined","options: InitOptions","name","options: {\n      provider?: string;\n      providers?: string;\n      enableOpenapi?: boolean;\n    }","options: { port?: string; enableOpenapi?: boolean }","options: { output?: string; json?: boolean }","options: { input?: string; output?: string; name?: string }"],"sources":["../package.json","../src/index.ts"],"sourcesContent":["{\n  \"name\": \"@geekmidas/cli\",\n  \"version\": \"0.5.1\",\n  \"description\": \"CLI tools for building Lambda handlers, server applications, and generating OpenAPI specs\",\n  \"private\": false,\n  \"type\": \"module\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.mjs\",\n      \"require\": \"./dist/index.cjs\"\n    },\n    \"./config\": {\n      \"types\": \"./dist/config.d.ts\",\n      \"import\": \"./dist/config.mjs\",\n      \"require\": \"./dist/config.cjs\"\n    },\n    \"./openapi\": {\n      \"types\": \"./dist/openapi.d.ts\",\n      \"import\": \"./dist/openapi.mjs\",\n      \"require\": \"./dist/openapi.cjs\"\n    },\n    \"./openapi-react-query\": {\n      \"types\": \"./dist/openapi-react-query.d.ts\",\n      \"import\": \"./dist/openapi-react-query.mjs\",\n      \"require\": \"./dist/openapi-react-query.cjs\"\n    }\n  },\n  \"bin\": {\n    \"gkm\": \"./dist/index.cjs\"\n  },\n  \"scripts\": {\n    \"ts\": \"tsc --noEmit --skipLibCheck src/**/*.ts\",\n    \"test\": \"vitest\",\n    \"test:once\": \"vitest run\",\n    \"test:coverage\": \"vitest run --coverage\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/geekmidas/toolbox\"\n  },\n  \"dependencies\": {\n    \"@apidevtools/swagger-parser\": \"^10.1.0\",\n    \"chokidar\": \"~4.0.3\",\n    \"commander\": \"^12.1.0\",\n    \"dotenv\": \"~17.2.3\",\n    \"fast-glob\": \"^3.3.2\",\n    \"lodash.kebabcase\": \"^4.1.1\",\n    \"openapi-typescript\": \"^7.4.2\",\n    \"prompts\": \"~2.4.2\"\n  },\n  \"devDependencies\": {\n    \"@geekmidas/testkit\": \"workspace:*\",\n    \"@types/lodash.kebabcase\": \"^4.1.9\",\n    \"@types/node\": \"~24.9.1\",\n    \"@types/prompts\": \"~2.4.9\",\n    \"typescript\": \"^5.8.2\",\n    \"vitest\": \"^3.2.4\",\n    \"zod\": \"~4.1.13\"\n  },\n  \"peerDependencies\": {\n    \"@geekmidas/constructs\": \"workspace:~\",\n    \"@geekmidas/envkit\": \"workspace:~\",\n    \"@geekmidas/logger\": \"workspace:~\",\n    \"@geekmidas/schema\": \"workspace:~\",\n    \"@geekmidas/telescope\": \"workspace:~\"\n  },\n  \"peerDependenciesMeta\": {\n    \"@geekmidas/telescope\": {\n      \"optional\": true\n    }\n  }\n}\n","#!/usr/bin/env -S npx tsx\n\nimport { Command } from 'commander';\nimport pkg from '../package.json' assert { type: 'json' };\nimport { buildCommand } from './build/index.ts';\nimport { devCommand } from './dev/index.ts';\nimport { type InitOptions, initCommand } from './init/index.ts';\nimport { generateReactQueryCommand } from './openapi-react-query.ts';\nimport { openapiCommand } from './openapi.ts';\nimport type { LegacyProvider, MainProvider } from './types.ts';\n\nconst program = new Command();\n\nprogram\n  .name('gkm')\n  .description('GeekMidas backend framework CLI')\n  .version(pkg.version)\n  .option('--cwd <path>', 'Change working directory');\n\nprogram\n  .command('init')\n  .description('Scaffold a new project')\n  .argument('[name]', 'Project name')\n  .option(\n    '--template <template>',\n    'Project template (minimal, api, serverless, worker)',\n  )\n  .option('--skip-install', 'Skip dependency installation', false)\n  .option('-y, --yes', 'Skip prompts, use defaults', false)\n  .option('--monorepo', 'Setup as monorepo with packages/models', false)\n  .option('--api-path <path>', 'API app path in monorepo (default: apps/api)')\n  .action(async (name: string | undefined, options: InitOptions) => {\n    try {\n      const globalOptions = program.opts();\n      if (globalOptions.cwd) {\n        process.chdir(globalOptions.cwd);\n      }\n      await initCommand(name, options);\n    } catch (error) {\n      console.error('Init failed:', (error as Error).message);\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('build')\n  .description('Build handlers from endpoints, functions, and crons')\n  .option(\n    '--provider <provider>',\n    'Target provider for generated handlers (aws, server)',\n  )\n  .option(\n    '--providers <providers>',\n    '[DEPRECATED] Use --provider instead. Target providers for generated handlers (comma-separated)',\n  )\n  .option(\n    '--enable-openapi',\n    'Enable OpenAPI documentation generation for server builds',\n  )\n  .action(\n    async (options: {\n      provider?: string;\n      providers?: string;\n      enableOpenapi?: boolean;\n    }) => {\n      try {\n        const globalOptions = program.opts();\n        if (globalOptions.cwd) {\n          process.chdir(globalOptions.cwd);\n        }\n\n        // Handle new single provider option\n        if (options.provider) {\n          if (!['aws', 'server'].includes(options.provider)) {\n            console.error(\n              `Invalid provider: ${options.provider}. Must be 'aws' or 'server'.`,\n            );\n            process.exit(1);\n          }\n          await buildCommand({\n            provider: options.provider as MainProvider,\n            enableOpenApi: options.enableOpenapi || false,\n          });\n        }\n        // Handle legacy providers option\n        else if (options.providers) {\n          console.warn(\n            '⚠️  --providers flag is deprecated. Use --provider instead.',\n          );\n          const providerList = [\n            ...new Set(options.providers.split(',').map((p) => p.trim())),\n          ] as LegacyProvider[];\n          await buildCommand({\n            providers: providerList,\n            enableOpenApi: options.enableOpenapi || false,\n          });\n        }\n        // Default to config-driven build\n        else {\n          await buildCommand({\n            enableOpenApi: options.enableOpenapi || false,\n          });\n        }\n      } catch (error) {\n        console.error('Build failed:', (error as Error).message);\n        process.exit(1);\n      }\n    },\n  );\n\nprogram\n  .command('dev')\n  .description('Start development server with automatic reload')\n  .option('--port <port>', 'Port to run the development server on', '3000')\n  .option(\n    '--enable-openapi',\n    'Enable OpenAPI documentation for development server',\n    true,\n  )\n  .action(async (options: { port?: string; enableOpenapi?: boolean }) => {\n    try {\n      const globalOptions = program.opts();\n      if (globalOptions.cwd) {\n        process.chdir(globalOptions.cwd);\n      }\n\n      await devCommand({\n        port: options.port ? Number.parseInt(options.port) : 3000,\n        enableOpenApi: options.enableOpenapi ?? true,\n      });\n    } catch (error) {\n      console.error('Dev server failed:', (error as Error).message);\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('cron')\n  .description('Manage cron jobs')\n  .action(() => {\n    const globalOptions = program.opts();\n    if (globalOptions.cwd) {\n      process.chdir(globalOptions.cwd);\n    }\n    process.stdout.write('Cron management - coming soon\\n');\n  });\n\nprogram\n  .command('function')\n  .description('Manage serverless functions')\n  .action(() => {\n    const globalOptions = program.opts();\n    if (globalOptions.cwd) {\n      process.chdir(globalOptions.cwd);\n    }\n    process.stdout.write('Serverless function management - coming soon\\n');\n  });\n\nprogram\n  .command('api')\n  .description('Manage REST API endpoints')\n  .action(() => {\n    const globalOptions = program.opts();\n    if (globalOptions.cwd) {\n      process.chdir(globalOptions.cwd);\n    }\n    process.stdout.write('REST API management - coming soon\\n');\n  });\n\nprogram\n  .command('openapi')\n  .description(\n    'Generate OpenAPI specification from endpoints (TypeScript by default)',\n  )\n  .option(\n    '--output <path>',\n    'Output file path for the OpenAPI spec',\n    'openapi.ts',\n  )\n  .option('--json', 'Generate JSON instead of TypeScript (legacy)', false)\n  .action(async (options: { output?: string; json?: boolean }) => {\n    try {\n      const globalOptions = program.opts();\n      if (globalOptions.cwd) {\n        process.chdir(globalOptions.cwd);\n      }\n      await openapiCommand(options);\n    } catch (error) {\n      console.error('OpenAPI generation failed:', (error as Error).message);\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('generate:react-query')\n  .description('Generate React Query hooks from OpenAPI specification')\n  .option('--input <path>', 'Input OpenAPI spec file path', 'openapi.json')\n  .option(\n    '--output <path>',\n    'Output file path for generated hooks',\n    'src/api/hooks.ts',\n  )\n  .option('--name <name>', 'API name prefix for generated code', 'API')\n  .action(\n    async (options: { input?: string; output?: string; name?: string }) => {\n      try {\n        const globalOptions = program.opts();\n        if (globalOptions.cwd) {\n          process.chdir(globalOptions.cwd);\n        }\n        await generateReactQueryCommand(options);\n      } catch (error) {\n        console.error(\n          'React Query generation failed:',\n          (error as Error).message,\n        );\n        process.exit(1);\n      }\n    },\n  );\n\nprogram.parse();\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/cli",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "CLI tools for building Lambda handlers, server applications, and generating OpenAPI specs",
   "private": false,
   "type": "module",
@@ -53,11 +53,11 @@
     "@geekmidas/testkit": "0.0.17"
   },
   "peerDependencies": {
-    "@geekmidas/constructs": "~0.2.0",
+    "@geekmidas/constructs": "~0.2.1",
     "@geekmidas/envkit": "~0.1.0",
     "@geekmidas/logger": "~0.0.1",
     "@geekmidas/telescope": "~0.0.1",
-    "@geekmidas/schema": "~0.0.2"
+    "@geekmidas/schema": "~0.0.3"
   },
   "peerDependenciesMeta": {
     "@geekmidas/telescope": {

package/src/dev/__tests__/index.spec.ts

@@ -1,15 +1,37 @@
+import type { AddressInfo } from 'node:net';
 import { createServer } from 'node:net';
-import { describe, expect, it } from 'vitest';
+import { afterEach, describe, expect, it } from 'vitest';
 import {
   findAvailablePort,
   isPortAvailable,
   normalizeTelescopeConfig,
 } from '../index';
 
+// Track servers to clean up after each test
+const activeServers: ReturnType<typeof createServer>[] = [];
+
+afterEach(async () => {
+  // Close all servers and wait for them to fully close
+  await Promise.all(
+    activeServers.map(
+      (server) =>
+        new Promise<void>((resolve) => {
+          server.close(() => resolve());
+        }),
+    ),
+  );
+  activeServers.length = 0;
+  // Give OS time to release ports
+  await new Promise((resolve) => setTimeout(resolve, 50));
+});
+
 /**
- * Helper to occupy a port for testing
+ * Helper to occupy a port for testing.
+ * Pass port 0 to get a random available port.
  */
-function occupyPort(port: number): Promise<ReturnType<typeof createServer>> {
+function occupyPort(
+  port: number,
+): Promise<{ server: ReturnType<typeof createServer>; port: number }> {
   return new Promise((resolve, reject) => {
     const server = createServer();
 
@@ -18,7 +40,9 @@ function occupyPort(port: number): Promise<ReturnType<typeof createServer>> {
     });
 
     server.once('listening', () => {
-      resolve(server);
+      activeServers.push(server);
+      const actualPort = (server.address() as AddressInfo).port;
+      resolve({ server, port: actualPort });
     });
 
     server.listen(port);
@@ -28,127 +52,99 @@ function occupyPort(port: number): Promise<ReturnType<typeof createServer>> {
 describe('Port Availability Functions', () => {
   describe('isPortAvailable', () => {
     it('should return true for an available port', async () => {
-      // Use a high port number to avoid conflicts
-      const port = 45000;
+      // Get a random port, close it, then check availability
+      const { server, port } = await occupyPort(0);
+      server.close();
+      await new Promise((resolve) => setTimeout(resolve, 50));
+
       const available = await isPortAvailable(port);
       expect(available).toBe(true);
     });
 
     it('should return false for a port in use', async () => {
-      const port = 45001;
-      const server = await occupyPort(port);
-
-      try {
-        const available = await isPortAvailable(port);
-        expect(available).toBe(false);
-      } finally {
-        server.close();
-      }
+      const { port } = await occupyPort(0);
+
+      const available = await isPortAvailable(port);
+      expect(available).toBe(false);
+      // Server cleanup handled by afterEach
     });
 
     it('should handle multiple sequential checks correctly', async () => {
-      const port = 45002;
+      // Get a port to test with
+      const { server: tempServer, port } = await occupyPort(0);
+      tempServer.close();
+      await new Promise((resolve) => setTimeout(resolve, 50));
 
       // First check - port should be available
       const firstCheck = await isPortAvailable(port);
       expect(firstCheck).toBe(true);
 
       // Occupy the port
-      const server = await occupyPort(port);
-
-      try {
-        // Second check - port should be unavailable
-        const secondCheck = await isPortAvailable(port);
-        expect(secondCheck).toBe(false);
-      } finally {
-        server.close();
-      }
-
-      // Give a moment for the port to be released
-      await new Promise((resolve) => setTimeout(resolve, 100));
-
-      // Third check - port should be available again
-      const thirdCheck = await isPortAvailable(port);
-      expect(thirdCheck).toBe(true);
+      await occupyPort(port);
+
+      // Second check - port should be unavailable
+      const secondCheck = await isPortAvailable(port);
+      expect(secondCheck).toBe(false);
+      // Server cleanup and third check handled by afterEach
     });
   });
 
   describe('findAvailablePort', () => {
     it('should return the preferred port if available', async () => {
-      const preferredPort = 45100;
+      // Get a random port, close it, then use as preferred
+      const { server, port: preferredPort } = await occupyPort(0);
+      server.close();
+      await new Promise((resolve) => setTimeout(resolve, 50));
+
       const foundPort = await findAvailablePort(preferredPort);
       expect(foundPort).toBe(preferredPort);
     });
 
     it('should return the next available port if preferred is in use', async () => {
-      const preferredPort = 45101;
-      const server = await occupyPort(preferredPort);
-
-      try {
-        const foundPort = await findAvailablePort(preferredPort);
-        expect(foundPort).toBe(preferredPort + 1);
-      } finally {
-        server.close();
-      }
+      const { port: preferredPort } = await occupyPort(0);
+
+      const foundPort = await findAvailablePort(preferredPort);
+      expect(foundPort).toBe(preferredPort + 1);
     });
 
     it('should skip multiple occupied ports', async () => {
-      const preferredPort = 45102;
-      const server1 = await occupyPort(preferredPort);
-      const server2 = await occupyPort(preferredPort + 1);
-      const server3 = await occupyPort(preferredPort + 2);
-
-      try {
-        const foundPort = await findAvailablePort(preferredPort);
-        expect(foundPort).toBe(preferredPort + 3);
-      } finally {
-        server1.close();
-        server2.close();
-        server3.close();
-      }
+      // Get a base port
+      const { port: basePort } = await occupyPort(0);
+      // Occupy consecutive ports
+      await occupyPort(basePort + 1);
+      await occupyPort(basePort + 2);
+
+      const foundPort = await findAvailablePort(basePort);
+      expect(foundPort).toBe(basePort + 3);
     });
 
     it('should throw error if no available port found within max attempts', async () => {
-      const preferredPort = 45103;
+      const { port: preferredPort } = await occupyPort(0);
       const maxAttempts = 3;
 
-      // Occupy ports 45103, 45104, 45105
-      const servers = await Promise.all([
-        occupyPort(preferredPort),
-        occupyPort(preferredPort + 1),
-        occupyPort(preferredPort + 2),
-      ]);
-
-      try {
-        await expect(
-          findAvailablePort(preferredPort, maxAttempts),
-        ).rejects.toThrow(
-          `Could not find an available port after trying ${maxAttempts} ports starting from ${preferredPort}`,
-        );
-      } finally {
-        servers.forEach((server) => server.close());
-      }
+      // Occupy consecutive ports
+      await occupyPort(preferredPort + 1);
+      await occupyPort(preferredPort + 2);
+
+      await expect(
+        findAvailablePort(preferredPort, maxAttempts),
+      ).rejects.toThrow(
+        `Could not find an available port after trying ${maxAttempts} ports starting from ${preferredPort}`,
+      );
     });
 
     it('should respect custom maxAttempts parameter', async () => {
-      const preferredPort = 45104;
+      const { port: preferredPort } = await occupyPort(0);
       const maxAttempts = 5;
 
-      // Occupy first 4 ports
-      const servers = await Promise.all([
-        occupyPort(preferredPort),
-        occupyPort(preferredPort + 1),
-        occupyPort(preferredPort + 2),
-        occupyPort(preferredPort + 3),
-      ]);
-
-      try {
-        const foundPort = await findAvailablePort(preferredPort, maxAttempts);
-        // Should find port at preferredPort + 4 (within 5 attempts)
-        expect(foundPort).toBe(preferredPort + 4);
-      } finally {
-        servers.forEach((server) => server.close());
-      }
+      // Occupy consecutive ports (4 total including base)
+      await occupyPort(preferredPort + 1);
+      await occupyPort(preferredPort + 2);
+      await occupyPort(preferredPort + 3);
+
+      const foundPort = await findAvailablePort(preferredPort, maxAttempts);
+      // Should find port at preferredPort + 4 (within 5 attempts)
+      expect(foundPort).toBe(preferredPort + 4);
     });
   });
 });
@@ -156,58 +152,57 @@ describe('Port Availability Functions', () => {
 describe('DevServer', () => {
   describe('port selection', () => {
     it('should use requested port when available', async () => {
-      // This is more of an integration test that would need the actual DevServer
-      // For now, we test the underlying logic
-      const requestedPort = 45200;
+      // Get a random port, close it, then use as requested
+      const { server, port: requestedPort } = await occupyPort(0);
+      server.close();
+      await new Promise((resolve) => setTimeout(resolve, 50));
+
       const actualPort = await findAvailablePort(requestedPort);
       expect(actualPort).toBe(requestedPort);
     });
 
     it('should select alternative port when requested is in use', async () => {
-      const requestedPort = 45201;
-      const server = await occupyPort(requestedPort);
-
-      try {
-        const actualPort = await findAvailablePort(requestedPort);
-        expect(actualPort).not.toBe(requestedPort);
-        expect(actualPort).toBeGreaterThan(requestedPort);
-        expect(actualPort).toBeLessThanOrEqual(requestedPort + 10);
-      } finally {
-        server.close();
-      }
+      const { port: requestedPort } = await occupyPort(0);
+
+      const actualPort = await findAvailablePort(requestedPort);
+      expect(actualPort).not.toBe(requestedPort);
+      expect(actualPort).toBeGreaterThan(requestedPort);
+      expect(actualPort).toBeLessThanOrEqual(requestedPort + 10);
     });
   });
 });
 
 describe('devCommand edge cases', () => {
   it('should handle port conflicts gracefully', async () => {
-    const port = 45300;
-    const server = await occupyPort(port);
-
-    try {
-      // The dev command should find an alternative port
-      const alternativePort = await findAvailablePort(port);
-      expect(alternativePort).toBeGreaterThan(port);
-    } finally {
-      server.close();
-    }
+    const { port } = await occupyPort(0);
+
+    // The dev command should find an alternative port
+    const alternativePort = await findAvailablePort(port);
+    expect(alternativePort).toBeGreaterThan(port);
   });
 
   it('should handle concurrent port checks', async () => {
-    const basePort = 45400;
+    // Get three random available ports as base
+    const { server: s1, port: p1 } = await occupyPort(0);
+    const { server: s2, port: p2 } = await occupyPort(0);
+    const { server: s3, port: p3 } = await occupyPort(0);
+    s1.close();
+    s2.close();
+    s3.close();
+    await new Promise((resolve) => setTimeout(resolve, 50));
 
     // Run multiple port checks concurrently
     const results = await Promise.all([
-      findAvailablePort(basePort),
-      findAvailablePort(basePort + 5),
-      findAvailablePort(basePort + 10),
+      findAvailablePort(p1),
+      findAvailablePort(p2),
+      findAvailablePort(p3),
     ]);
 
     // All should succeed and return valid ports
     expect(results).toHaveLength(3);
-    results.forEach((port) => {
-      expect(port).toBeGreaterThanOrEqual(basePort);
-    });
+    expect(results[0]).toBe(p1);
+    expect(results[1]).toBe(p2);
+    expect(results[2]).toBe(p3);
   });
 });