@geekmidas/cli 0.8.0 → 0.10.0

package/dist/{config-Bq72aj8e.mjs → config-BrkUalUh.mjs}

@@ -40,7 +40,9 @@ function defineConfig(config) {
 * // { path: './src/config/env', importPattern: '{ myEnv as envParser }' }
 */
 function parseModuleConfig(configString, defaultAlias) {
-	const [path, exportName] = configString.split("#");
+	const parts = configString.split("#");
+	const path = parts[0] ?? configString;
+	const exportName = parts[1];
 	const importPattern = !exportName ? defaultAlias : exportName === defaultAlias ? `{ ${defaultAlias} }` : `{ ${exportName} as ${defaultAlias} }`;
 	return {
 		path,
@@ -72,4 +74,4 @@ async function loadConfig(cwd = process.cwd()) {
 
 //#endregion
 export { defineConfig, loadConfig, parseModuleConfig };
-//# sourceMappingURL=config-Bq72aj8e.mjs.map
+//# sourceMappingURL=config-BrkUalUh.mjs.map

package/dist/config-BrkUalUh.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-BrkUalUh.mjs","names":["config: GkmConfig","configString: string","defaultAlias: string","cwd: string"],"sources":["../src/config.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport { join } from 'path';\nimport type { GkmConfig } from './types.ts';\n\nexport type { GkmConfig } from './types.ts';\n/**\n * Define GKM configuration with full TypeScript support.\n * This is an identity function that provides type safety and autocomplete.\n *\n * @example\n * ```ts\n * // gkm.config.ts\n * import { defineConfig } from '@geekmidas/cli/config';\n *\n * export default defineConfig({\n *   routes: './src/endpoints/**\\/*.ts',\n *   envParser: './src/config/env',\n *   logger: './src/config/logger',\n *   telescope: true,\n * });\n * ```\n */\nexport function defineConfig(config: GkmConfig): GkmConfig {\n  return config;\n}\n\nexport interface ParsedModuleConfig {\n  path: string;\n  importPattern: string;\n}\n\n/**\n * Parse a module config string into path and import pattern.\n *\n * @param configString - Config string in format \"./path/to/module\" or \"./path/to/module#exportName\"\n * @param defaultAlias - The default alias name to use if no export name specified\n * @returns Object with path and import pattern\n *\n * @example\n * parseModuleConfig('./src/config/env', 'envParser')\n * // { path: './src/config/env', importPattern: 'envParser' }\n *\n * parseModuleConfig('./src/config/env#envParser', 'envParser')\n * // { path: './src/config/env', importPattern: '{ envParser }' }\n *\n * parseModuleConfig('./src/config/env#myEnv', 'envParser')\n * // { path: './src/config/env', importPattern: '{ myEnv as envParser }' }\n */\nexport function parseModuleConfig(\n  configString: string,\n  defaultAlias: string,\n): ParsedModuleConfig {\n  const parts = configString.split('#');\n  const path = parts[0] ?? configString;\n  const exportName = parts[1];\n  const importPattern = !exportName\n    ? defaultAlias\n    : exportName === defaultAlias\n      ? `{ ${defaultAlias} }`\n      : `{ ${exportName} as ${defaultAlias} }`;\n\n  return { path, importPattern };\n}\n\nexport async function loadConfig(\n  cwd: string = process.cwd(),\n): Promise<GkmConfig> {\n  const files = ['gkm.config.json', 'gkm.config.ts', 'gkm.config.js'];\n  let configPath = '';\n\n  for (const file of files) {\n    const path = join(cwd, file);\n    if (existsSync(path)) {\n      configPath = path;\n      break;\n    }\n  }\n\n  if (!configPath) {\n    throw new Error(\n      'Configuration file not found. Please create gkm.config.json, gkm.config.ts, or gkm.config.js in the project root.',\n    );\n  }\n\n  try {\n    const config = await import(configPath);\n    return config.default;\n  } catch (error) {\n    throw new Error(\n      `Failed to load gkm.config.json: ${(error as Error).message}`,\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,aAAaA,QAA8B;AACzD,QAAO;AACR;;;;;;;;;;;;;;;;;;AAwBD,SAAgB,kBACdC,cACAC,cACoB;CACpB,MAAM,QAAQ,aAAa,MAAM,IAAI;CACrC,MAAM,OAAO,MAAM,MAAM;CACzB,MAAM,aAAa,MAAM;CACzB,MAAM,iBAAiB,aACnB,eACA,eAAe,gBACZ,IAAI,aAAa,OACjB,IAAI,WAAW,MAAM,aAAa;AAEzC,QAAO;EAAE;EAAM;CAAe;AAC/B;AAED,eAAsB,WACpBC,MAAc,QAAQ,KAAK,EACP;CACpB,MAAM,QAAQ;EAAC;EAAmB;EAAiB;CAAgB;CACnE,IAAI,aAAa;AAEjB,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,OAAO,KAAK,KAAK,KAAK;AAC5B,MAAI,WAAW,KAAK,EAAE;AACpB,gBAAa;AACb;EACD;CACF;AAED,MAAK,WACH,OAAM,IAAI,MACR;AAIJ,KAAI;EACF,MAAM,SAAS,MAAM,OAAO;AAC5B,SAAO,OAAO;CACf,SAAQ,OAAO;AACd,QAAM,IAAI,OACP,kCAAmC,MAAgB,QAAQ;CAE/D;AACF"}

package/dist/{config-CFls09Ey.cjs → config-C9aXOHBe.cjs}

@@ -41,7 +41,9 @@ function defineConfig(config) {
 * // { path: './src/config/env', importPattern: '{ myEnv as envParser }' }
 */
 function parseModuleConfig(configString, defaultAlias) {
-	const [path$1, exportName] = configString.split("#");
+	const parts = configString.split("#");
+	const path$1 = parts[0] ?? configString;
+	const exportName = parts[1];
 	const importPattern = !exportName ? defaultAlias : exportName === defaultAlias ? `{ ${defaultAlias} }` : `{ ${exportName} as ${defaultAlias} }`;
 	return {
 		path: path$1,
@@ -90,4 +92,4 @@ Object.defineProperty(exports, 'parseModuleConfig', {
     return parseModuleConfig;
   }
 });
-//# sourceMappingURL=config-CFls09Ey.cjs.map
+//# sourceMappingURL=config-C9aXOHBe.cjs.map

package/dist/config-C9aXOHBe.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-C9aXOHBe.cjs","names":["config: GkmConfig","configString: string","defaultAlias: string","path","cwd: string"],"sources":["../src/config.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport { join } from 'path';\nimport type { GkmConfig } from './types.ts';\n\nexport type { GkmConfig } from './types.ts';\n/**\n * Define GKM configuration with full TypeScript support.\n * This is an identity function that provides type safety and autocomplete.\n *\n * @example\n * ```ts\n * // gkm.config.ts\n * import { defineConfig } from '@geekmidas/cli/config';\n *\n * export default defineConfig({\n *   routes: './src/endpoints/**\\/*.ts',\n *   envParser: './src/config/env',\n *   logger: './src/config/logger',\n *   telescope: true,\n * });\n * ```\n */\nexport function defineConfig(config: GkmConfig): GkmConfig {\n  return config;\n}\n\nexport interface ParsedModuleConfig {\n  path: string;\n  importPattern: string;\n}\n\n/**\n * Parse a module config string into path and import pattern.\n *\n * @param configString - Config string in format \"./path/to/module\" or \"./path/to/module#exportName\"\n * @param defaultAlias - The default alias name to use if no export name specified\n * @returns Object with path and import pattern\n *\n * @example\n * parseModuleConfig('./src/config/env', 'envParser')\n * // { path: './src/config/env', importPattern: 'envParser' }\n *\n * parseModuleConfig('./src/config/env#envParser', 'envParser')\n * // { path: './src/config/env', importPattern: '{ envParser }' }\n *\n * parseModuleConfig('./src/config/env#myEnv', 'envParser')\n * // { path: './src/config/env', importPattern: '{ myEnv as envParser }' }\n */\nexport function parseModuleConfig(\n  configString: string,\n  defaultAlias: string,\n): ParsedModuleConfig {\n  const parts = configString.split('#');\n  const path = parts[0] ?? configString;\n  const exportName = parts[1];\n  const importPattern = !exportName\n    ? defaultAlias\n    : exportName === defaultAlias\n      ? `{ ${defaultAlias} }`\n      : `{ ${exportName} as ${defaultAlias} }`;\n\n  return { path, importPattern };\n}\n\nexport async function loadConfig(\n  cwd: string = process.cwd(),\n): Promise<GkmConfig> {\n  const files = ['gkm.config.json', 'gkm.config.ts', 'gkm.config.js'];\n  let configPath = '';\n\n  for (const file of files) {\n    const path = join(cwd, file);\n    if (existsSync(path)) {\n      configPath = path;\n      break;\n    }\n  }\n\n  if (!configPath) {\n    throw new Error(\n      'Configuration file not found. Please create gkm.config.json, gkm.config.ts, or gkm.config.js in the project root.',\n    );\n  }\n\n  try {\n    const config = await import(configPath);\n    return config.default;\n  } catch (error) {\n    throw new Error(\n      `Failed to load gkm.config.json: ${(error as Error).message}`,\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,aAAaA,QAA8B;AACzD,QAAO;AACR;;;;;;;;;;;;;;;;;;AAwBD,SAAgB,kBACdC,cACAC,cACoB;CACpB,MAAM,QAAQ,aAAa,MAAM,IAAI;CACrC,MAAMC,SAAO,MAAM,MAAM;CACzB,MAAM,aAAa,MAAM;CACzB,MAAM,iBAAiB,aACnB,eACA,eAAe,gBACZ,IAAI,aAAa,OACjB,IAAI,WAAW,MAAM,aAAa;AAEzC,QAAO;EAAE;EAAM;CAAe;AAC/B;AAED,eAAsB,WACpBC,MAAc,QAAQ,KAAK,EACP;CACpB,MAAM,QAAQ;EAAC;EAAmB;EAAiB;CAAgB;CACnE,IAAI,aAAa;AAEjB,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAMD,SAAO,eAAK,KAAK,KAAK;AAC5B,MAAI,mBAAWA,OAAK,EAAE;AACpB,gBAAaA;AACb;EACD;CACF;AAED,MAAK,WACH,OAAM,IAAI,MACR;AAIJ,KAAI;EACF,MAAM,SAAS,MAAM,OAAO;AAC5B,SAAO,OAAO;CACf,SAAQ,OAAO;AACd,QAAM,IAAI,OACP,kCAAmC,MAAgB,QAAQ;CAE/D;AACF"}

package/dist/config.cjs

@@ -1,4 +1,4 @@
-const require_config = require('./config-CFls09Ey.cjs');
+const require_config = require('./config-C9aXOHBe.cjs');
 
 exports.defineConfig = require_config.defineConfig;
 exports.loadConfig = require_config.loadConfig;

package/dist/config.d.cts

@@ -43,6 +43,7 @@ interface ParsedModuleConfig {
  */
 declare function parseModuleConfig(configString: string, defaultAlias: string): ParsedModuleConfig;
 declare function loadConfig(cwd?: string): Promise<GkmConfig>;
+//# sourceMappingURL=config.d.ts.map
 //#endregion
 export { GkmConfig, ParsedModuleConfig, defineConfig, loadConfig, parseModuleConfig };
 //# sourceMappingURL=config.d.cts.map

package/dist/config.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.cts","names":[],"sources":["../src/config.ts"],"sourcesContent":[],"mappings":";;;;;AAsBA;;;;AAA0D;AAI1D;AAsBA;AAgBA;;;;AAEU;;;;;iBA5CM,YAAA,SAAqB,YAAY;UAIhC,kBAAA;;;;;;;;;;;;;;;;;;;;;iBAsBD,iBAAA,8CAGb;iBAamB,UAAA,gBAEnB,QAAQ"}

package/dist/config.d.mts

@@ -43,6 +43,7 @@ interface ParsedModuleConfig {
  */
 declare function parseModuleConfig(configString: string, defaultAlias: string): ParsedModuleConfig;
 declare function loadConfig(cwd?: string): Promise<GkmConfig>;
+//# sourceMappingURL=config.d.ts.map
 //#endregion
 export { GkmConfig, ParsedModuleConfig, defineConfig, loadConfig, parseModuleConfig };
 //# sourceMappingURL=config.d.mts.map

package/dist/config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.mts","names":[],"sources":["../src/config.ts"],"sourcesContent":[],"mappings":";;;;;AAsBA;;;;AAA0D;AAI1D;AAsBA;AAgBA;;;;AAEU;;;;;iBA5CM,YAAA,SAAqB,YAAY;UAIhC,kBAAA;;;;;;;;;;;;;;;;;;;;;iBAsBD,iBAAA,8CAGb;iBAamB,UAAA,gBAEnB,QAAQ"}

package/dist/config.mjs

@@ -1,3 +1,3 @@
-import { defineConfig, loadConfig, parseModuleConfig } from "./config-Bq72aj8e.mjs";
+import { defineConfig, loadConfig, parseModuleConfig } from "./config-BrkUalUh.mjs";
 
 export { defineConfig, loadConfig, parseModuleConfig };

package/dist/index.cjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env -S npx tsx
 const require_chunk = require('./chunk-CUT6urMc.cjs');
-const require_config = require('./config-CFls09Ey.cjs');
-const require_openapi = require('./openapi-CHhTPief.cjs');
+const require_config = require('./config-C9aXOHBe.cjs');
+const require_openapi = require('./openapi-BeHLKcwP.cjs');
 const require_openapi_react_query = require('./openapi-react-query-o5iMi8tz.cjs');
 const path = require_chunk.__toESM(require("path"));
 const commander = require_chunk.__toESM(require("commander"));
@@ -20,7 +20,7 @@ const prompts = require_chunk.__toESM(require("prompts"));
 
 //#region package.json
 var name = "@geekmidas/cli";
-var version = "0.8.0";
+var version = "0.10.0";
 var description = "CLI tools for building Lambda handlers, server applications, and generating OpenAPI specs";
 var private$1 = false;
 var type = "module";
@@ -621,11 +621,12 @@ async function devCommand(options) {
 	await buildServer(config, buildContext, resolved.providers[0], enableOpenApi);
 	if (enableOpenApi) await require_openapi.generateOpenApi(config);
 	const runtime = config.runtime ?? "node";
-	const devServer = new DevServer(resolved.providers[0], options.port || 3e3, enableOpenApi, telescope, studio, runtime);
+	const devServer = new DevServer(resolved.providers[0], options.port || 3e3, options.portExplicit ?? false, enableOpenApi, telescope, studio, runtime);
 	await devServer.start();
-	const envParserFile = config.envParser.split("#")[0];
-	const loggerFile = config.logger.split("#")[0];
-	const hooksFile = config.hooks?.server?.split("#")[0];
+	const envParserFile = config.envParser.split("#")[0] ?? config.envParser;
+	const loggerFile = config.logger.split("#")[0] ?? config.logger;
+	const hooksFileParts = config.hooks?.server?.split("#");
+	const hooksFile = hooksFileParts?.[0];
 	const watchPatterns = [
 		config.routes,
 		...config.functions ? [config.functions] : [],
@@ -634,7 +635,7 @@ async function devCommand(options) {
 		envParserFile.endsWith(".ts") ? envParserFile : `${envParserFile}.ts`,
 		loggerFile.endsWith(".ts") ? loggerFile : `${loggerFile}.ts`,
 		...hooksFile ? [hooksFile.endsWith(".ts") ? hooksFile : `${hooksFile}.ts`] : []
-	].flat();
+	].flat().filter((p) => typeof p === "string");
 	const normalizedPatterns = watchPatterns.map((p) => p.startsWith("./") ? p.slice(2) : p);
 	logger$2.log(`👀 Watching for changes in: ${normalizedPatterns.join(", ")}`);
 	const resolvedFiles = await (0, fast_glob.default)(normalizedPatterns, {
@@ -642,7 +643,10 @@ async function devCommand(options) {
 		absolute: false,
 		onlyFiles: true
 	});
-	const dirsToWatch = [...new Set(resolvedFiles.map((f) => f.split("/").slice(0, -1).join("/")))];
+	const dirsToWatch = [...new Set(resolvedFiles.map((f) => {
+		const parts = f.split("/");
+		return parts.slice(0, -1).join("/");
+	}))];
 	logger$2.log(`📁 Found ${resolvedFiles.length} files in ${dirsToWatch.length} directories`);
 	const watcher = chokidar.default.watch([...resolvedFiles, ...dirsToWatch], {
 		ignored: /(^|[\/\\])\../,
@@ -713,9 +717,10 @@ var DevServer = class {
 	serverProcess = null;
 	isRunning = false;
 	actualPort;
-	constructor(provider, requestedPort, enableOpenApi, telescope, studio, runtime = "node") {
+	constructor(provider, requestedPort, portExplicit, enableOpenApi, telescope, studio, runtime = "node") {
 		this.provider = provider;
 		this.requestedPort = requestedPort;
+		this.portExplicit = portExplicit;
 		this.enableOpenApi = enableOpenApi;
 		this.telescope = telescope;
 		this.studio = studio;
@@ -724,8 +729,14 @@ var DevServer = class {
 	}
 	async start() {
 		if (this.isRunning) await this.stop();
-		this.actualPort = await findAvailablePort(this.requestedPort);
-		if (this.actualPort !== this.requestedPort) logger$2.log(`ℹ️  Port ${this.requestedPort} was in use, using port ${this.actualPort} instead`);
+		if (this.portExplicit) {
+			const available = await isPortAvailable(this.requestedPort);
+			if (!available) throw new Error(`Port ${this.requestedPort} is already in use. Either stop the process using that port or omit -p/--port to auto-select an available port.`);
+			this.actualPort = this.requestedPort;
+		} else {
+			this.actualPort = await findAvailablePort(this.requestedPort);
+			if (this.actualPort !== this.requestedPort) logger$2.log(`ℹ️  Port ${this.requestedPort} was in use, using port ${this.actualPort} instead`);
+		}
 		const serverEntryPath = (0, node_path.join)(process.cwd(), ".gkm", this.provider, "server.ts");
 		await this.createServerEntry();
 		logger$2.log(`\n✨ Starting server on port ${this.actualPort}...`);
@@ -2701,12 +2712,13 @@ program.command("build").description("Build handlers from endpoints, functions,
 		process.exit(1);
 	}
 });
-program.command("dev").description("Start development server with automatic reload").option("--port <port>", "Port to run the development server on", "3000").option("--enable-openapi", "Enable OpenAPI documentation for development server", true).action(async (options) => {
+program.command("dev").description("Start development server with automatic reload").option("-p, --port <port>", "Port to run the development server on").option("--enable-openapi", "Enable OpenAPI documentation for development server", true).action(async (options) => {
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 		await devCommand({
 			port: options.port ? Number.parseInt(options.port) : 3e3,
+			portExplicit: !!options.port,
 			enableOpenApi: options.enableOpenapi ?? true
 		});
 	} catch (error) {
@@ -2729,11 +2741,11 @@ program.command("api").description("Manage REST API endpoints").action(() => {
 	if (globalOptions.cwd) process.chdir(globalOptions.cwd);
 	process.stdout.write("REST API management - coming soon\n");
 });
-program.command("openapi").description("Generate OpenAPI specification from endpoints (TypeScript by default)").option("--output <path>", "Output file path for the OpenAPI spec", "openapi.ts").option("--json", "Generate JSON instead of TypeScript (legacy)", false).action(async (options) => {
+program.command("openapi").description("Generate OpenAPI specification from endpoints").action(async () => {
 	try {
 		const globalOptions = program.opts();
 		if (globalOptions.cwd) process.chdir(globalOptions.cwd);
-		await require_openapi.openapiCommand(options);
+		await require_openapi.openapiCommand({});
 	} catch (error) {
 		console.error("OpenAPI generation failed:", error.message);
 		process.exit(1);