@geekmidas/cli 0.4.0 → 0.5.0

package/dist/worker--8O5a3Hv.cjs

@@ -0,0 +1,150 @@
+
+//#region src/init/templates/worker.ts
+const workerTemplate = {
+	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) => {
+		const files = [
+			{
+				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();
+`
+			},
+			{
+				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',
+});
+`
+			},
+			{
+				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(),
+  }));
+`
+			},
+			{
+				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 }>;
+`
+			},
+			{
+				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;
+    }
+  });
+`
+			},
+			{
+				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');
+  });
+`
+			}
+		];
+		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;
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'workerTemplate', {
+  enumerable: true,
+  get: function () {
+    return workerTemplate;
+  }
+});
+//# sourceMappingURL=worker--8O5a3Hv.cjs.map

package/dist/worker--8O5a3Hv.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker--8O5a3Hv.cjs","names":["workerTemplate: TemplateConfig","options: TemplateOptions","files: GeneratedFile[]"],"sources":["../src/init/templates/worker.ts"],"sourcesContent":["import type {\n  GeneratedFile,\n  TemplateConfig,\n  TemplateOptions,\n} from './index.js';\n\nexport const workerTemplate: TemplateConfig = {\n  name: 'worker',\n  description: 'Background job processing',\n\n  dependencies: {\n    '@geekmidas/constructs': 'workspace:*',\n    '@geekmidas/envkit': 'workspace:*',\n    '@geekmidas/logger': 'workspace:*',\n    '@geekmidas/events': 'workspace:*',\n    hono: '~4.8.2',\n    pino: '~9.6.0',\n  },\n\n  devDependencies: {\n    '@biomejs/biome': '~1.9.4',\n    '@geekmidas/cli': 'workspace:*',\n    '@types/node': '~22.0.0',\n    tsx: '~4.20.0',\n    turbo: '~2.3.0',\n    typescript: '~5.8.2',\n    vitest: '~4.0.0',\n  },\n\n  scripts: {\n    dev: 'gkm dev',\n    build: 'gkm build',\n    test: 'vitest',\n    'test:once': 'vitest run',\n    typecheck: 'tsc --noEmit',\n    lint: 'biome lint .',\n    fmt: 'biome format . --write',\n    'fmt:check': 'biome format .',\n  },\n\n  files: (options: TemplateOptions): GeneratedFile[] => {\n    const files: GeneratedFile[] = [\n      // src/config/env.ts\n      {\n        path: 'src/config/env.ts',\n        content: `import { EnvironmentParser } from '@geekmidas/envkit';\n\nexport const envParser = new EnvironmentParser(process.env);\n\nexport const config = envParser\n  .create((get) => ({\n    port: get('PORT').string().transform(Number).default(3000),\n    nodeEnv: get('NODE_ENV').string().default('development'),\n    rabbitmq: {\n      url: get('RABBITMQ_URL').string().default('amqp://localhost:5672'),\n    },${\n      options.database\n        ? `\n    database: {\n      url: get('DATABASE_URL').string().default('postgresql://localhost:5432/mydb'),\n    },`\n        : ''\n    }\n  }))\n  .parse();\n`,\n      },\n\n      // src/config/logger.ts - using pino\n      {\n        path: 'src/config/logger.ts',\n        content: `import { PinoLogger } from '@geekmidas/logger/pino';\n\nexport const logger = new PinoLogger({\n  app: '${options.name}',\n  level: process.env.LOG_LEVEL || 'info',\n});\n`,\n      },\n\n      // src/endpoints/health.ts\n      {\n        path: 'src/endpoints/health.ts',\n        content: `import { e } from '@geekmidas/constructs/endpoints';\n\nexport default e\n  .get('/health')\n  .handle(async () => ({\n    status: 'ok',\n    timestamp: new Date().toISOString(),\n  }));\n`,\n      },\n\n      // src/events/types.ts\n      {\n        path: 'src/events/types.ts',\n        content: `import type { PublishableMessage } from '@geekmidas/events';\n\n// Define your event types here\nexport type AppEvents =\n  | PublishableMessage<'user.created', { userId: string; email: string }>\n  | PublishableMessage<'user.updated', { userId: string; changes: Record<string, unknown> }>\n  | PublishableMessage<'order.placed', { orderId: string; userId: string; total: number }>;\n`,\n      },\n\n      // src/subscribers/user-events.ts\n      {\n        path: 'src/subscribers/user-events.ts',\n        content: `import { s } from '@geekmidas/constructs/subscribers';\nimport type { AppEvents } from '../events/types.js';\n\nexport default s<AppEvents>()\n  .events(['user.created', 'user.updated'])\n  .handle(async ({ event, logger }) => {\n    logger.info({ type: event.type, payload: event.payload }, 'Processing user event');\n\n    switch (event.type) {\n      case 'user.created':\n        // Handle user creation\n        logger.info({ userId: event.payload.userId }, 'New user created');\n        break;\n      case 'user.updated':\n        // Handle user update\n        logger.info({ userId: event.payload.userId }, 'User updated');\n        break;\n    }\n  });\n`,\n      },\n\n      // src/crons/cleanup.ts\n      {\n        path: 'src/crons/cleanup.ts',\n        content: `import { cron } from '@geekmidas/constructs/crons';\n\n// Run every day at midnight\nexport default cron('0 0 * * *')\n  .handle(async ({ logger }) => {\n    logger.info('Running cleanup job');\n\n    // Add your cleanup logic here\n    // e.g., delete old sessions, clean up temp files, etc.\n\n    logger.info('Cleanup job completed');\n  });\n`,\n      },\n    ];\n\n    // Add Telescope config if enabled\n    if (options.telescope) {\n      files.push({\n        path: 'src/config/telescope.ts',\n        content: `import { Telescope } from '@geekmidas/telescope';\nimport { InMemoryStorage } from '@geekmidas/telescope/storage/memory';\n\nexport const telescope = new Telescope({\n  storage: new InMemoryStorage({ maxEntries: 100 }),\n  enabled: process.env.NODE_ENV === 'development',\n});\n`,\n      });\n    }\n\n    return files;\n  },\n};\n"],"mappings":";;AAMA,MAAaA,iBAAiC;CAC5C,MAAM;CACN,aAAa;CAEb,cAAc;EACZ,yBAAyB;EACzB,qBAAqB;EACrB,qBAAqB;EACrB,qBAAqB;EACrB,MAAM;EACN,MAAM;CACP;CAED,iBAAiB;EACf,kBAAkB;EAClB,kBAAkB;EAClB,eAAe;EACf,KAAK;EACL,OAAO;EACP,YAAY;EACZ,QAAQ;CACT;CAED,SAAS;EACP,KAAK;EACL,OAAO;EACP,MAAM;EACN,aAAa;EACb,WAAW;EACX,MAAM;EACN,KAAK;EACL,aAAa;CACd;CAED,OAAO,CAACC,YAA8C;EACpD,MAAMC,QAAyB;GAE7B;IACE,MAAM;IACN,UAAU;;;;;;;;;;QAWZ,QAAQ,YACH;;;UAID,GACL;;;;GAIE;GAGD;IACE,MAAM;IACN,UAAU;;;UAGR,QAAQ,KAAK;;;;GAIhB;GAGD;IACE,MAAM;IACN,UAAU;;;;;;;;;GASX;GAGD;IACE,MAAM;IACN,UAAU;;;;;;;;GAQX;GAGD;IACE,MAAM;IACN,UAAU;;;;;;;;;;;;;;;;;;;;GAoBX;GAGD;IACE,MAAM;IACN,UAAU;;;;;;;;;;;;;GAaX;EACF;AAGD,MAAI,QAAQ,UACV,OAAM,KAAK;GACT,MAAM;GACN,UAAU;;;;;;;;EAQX,EAAC;AAGJ,SAAO;CACR;AACF"}

package/dist/worker-Jme7uOOJ.mjs

@@ -0,0 +1,144 @@
+//#region src/init/templates/worker.ts
+const workerTemplate = {
+	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) => {
+		const files = [
+			{
+				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();
+`
+			},
+			{
+				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',
+});
+`
+			},
+			{
+				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(),
+  }));
+`
+			},
+			{
+				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 }>;
+`
+			},
+			{
+				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;
+    }
+  });
+`
+			},
+			{
+				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');
+  });
+`
+			}
+		];
+		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;
+	}
+};
+
+//#endregion
+export { workerTemplate };
+//# sourceMappingURL=worker-Jme7uOOJ.mjs.map

package/dist/worker-Jme7uOOJ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-Jme7uOOJ.mjs","names":["workerTemplate: TemplateConfig","options: TemplateOptions","files: GeneratedFile[]"],"sources":["../src/init/templates/worker.ts"],"sourcesContent":["import type {\n  GeneratedFile,\n  TemplateConfig,\n  TemplateOptions,\n} from './index.js';\n\nexport const workerTemplate: TemplateConfig = {\n  name: 'worker',\n  description: 'Background job processing',\n\n  dependencies: {\n    '@geekmidas/constructs': 'workspace:*',\n    '@geekmidas/envkit': 'workspace:*',\n    '@geekmidas/logger': 'workspace:*',\n    '@geekmidas/events': 'workspace:*',\n    hono: '~4.8.2',\n    pino: '~9.6.0',\n  },\n\n  devDependencies: {\n    '@biomejs/biome': '~1.9.4',\n    '@geekmidas/cli': 'workspace:*',\n    '@types/node': '~22.0.0',\n    tsx: '~4.20.0',\n    turbo: '~2.3.0',\n    typescript: '~5.8.2',\n    vitest: '~4.0.0',\n  },\n\n  scripts: {\n    dev: 'gkm dev',\n    build: 'gkm build',\n    test: 'vitest',\n    'test:once': 'vitest run',\n    typecheck: 'tsc --noEmit',\n    lint: 'biome lint .',\n    fmt: 'biome format . --write',\n    'fmt:check': 'biome format .',\n  },\n\n  files: (options: TemplateOptions): GeneratedFile[] => {\n    const files: GeneratedFile[] = [\n      // src/config/env.ts\n      {\n        path: 'src/config/env.ts',\n        content: `import { EnvironmentParser } from '@geekmidas/envkit';\n\nexport const envParser = new EnvironmentParser(process.env);\n\nexport const config = envParser\n  .create((get) => ({\n    port: get('PORT').string().transform(Number).default(3000),\n    nodeEnv: get('NODE_ENV').string().default('development'),\n    rabbitmq: {\n      url: get('RABBITMQ_URL').string().default('amqp://localhost:5672'),\n    },${\n      options.database\n        ? `\n    database: {\n      url: get('DATABASE_URL').string().default('postgresql://localhost:5432/mydb'),\n    },`\n        : ''\n    }\n  }))\n  .parse();\n`,\n      },\n\n      // src/config/logger.ts - using pino\n      {\n        path: 'src/config/logger.ts',\n        content: `import { PinoLogger } from '@geekmidas/logger/pino';\n\nexport const logger = new PinoLogger({\n  app: '${options.name}',\n  level: process.env.LOG_LEVEL || 'info',\n});\n`,\n      },\n\n      // src/endpoints/health.ts\n      {\n        path: 'src/endpoints/health.ts',\n        content: `import { e } from '@geekmidas/constructs/endpoints';\n\nexport default e\n  .get('/health')\n  .handle(async () => ({\n    status: 'ok',\n    timestamp: new Date().toISOString(),\n  }));\n`,\n      },\n\n      // src/events/types.ts\n      {\n        path: 'src/events/types.ts',\n        content: `import type { PublishableMessage } from '@geekmidas/events';\n\n// Define your event types here\nexport type AppEvents =\n  | PublishableMessage<'user.created', { userId: string; email: string }>\n  | PublishableMessage<'user.updated', { userId: string; changes: Record<string, unknown> }>\n  | PublishableMessage<'order.placed', { orderId: string; userId: string; total: number }>;\n`,\n      },\n\n      // src/subscribers/user-events.ts\n      {\n        path: 'src/subscribers/user-events.ts',\n        content: `import { s } from '@geekmidas/constructs/subscribers';\nimport type { AppEvents } from '../events/types.js';\n\nexport default s<AppEvents>()\n  .events(['user.created', 'user.updated'])\n  .handle(async ({ event, logger }) => {\n    logger.info({ type: event.type, payload: event.payload }, 'Processing user event');\n\n    switch (event.type) {\n      case 'user.created':\n        // Handle user creation\n        logger.info({ userId: event.payload.userId }, 'New user created');\n        break;\n      case 'user.updated':\n        // Handle user update\n        logger.info({ userId: event.payload.userId }, 'User updated');\n        break;\n    }\n  });\n`,\n      },\n\n      // src/crons/cleanup.ts\n      {\n        path: 'src/crons/cleanup.ts',\n        content: `import { cron } from '@geekmidas/constructs/crons';\n\n// Run every day at midnight\nexport default cron('0 0 * * *')\n  .handle(async ({ logger }) => {\n    logger.info('Running cleanup job');\n\n    // Add your cleanup logic here\n    // e.g., delete old sessions, clean up temp files, etc.\n\n    logger.info('Cleanup job completed');\n  });\n`,\n      },\n    ];\n\n    // Add Telescope config if enabled\n    if (options.telescope) {\n      files.push({\n        path: 'src/config/telescope.ts',\n        content: `import { Telescope } from '@geekmidas/telescope';\nimport { InMemoryStorage } from '@geekmidas/telescope/storage/memory';\n\nexport const telescope = new Telescope({\n  storage: new InMemoryStorage({ maxEntries: 100 }),\n  enabled: process.env.NODE_ENV === 'development',\n});\n`,\n      });\n    }\n\n    return files;\n  },\n};\n"],"mappings":";AAMA,MAAaA,iBAAiC;CAC5C,MAAM;CACN,aAAa;CAEb,cAAc;EACZ,yBAAyB;EACzB,qBAAqB;EACrB,qBAAqB;EACrB,qBAAqB;EACrB,MAAM;EACN,MAAM;CACP;CAED,iBAAiB;EACf,kBAAkB;EAClB,kBAAkB;EAClB,eAAe;EACf,KAAK;EACL,OAAO;EACP,YAAY;EACZ,QAAQ;CACT;CAED,SAAS;EACP,KAAK;EACL,OAAO;EACP,MAAM;EACN,aAAa;EACb,WAAW;EACX,MAAM;EACN,KAAK;EACL,aAAa;CACd;CAED,OAAO,CAACC,YAA8C;EACpD,MAAMC,QAAyB;GAE7B;IACE,MAAM;IACN,UAAU;;;;;;;;;;QAWZ,QAAQ,YACH;;;UAID,GACL;;;;GAIE;GAGD;IACE,MAAM;IACN,UAAU;;;UAGR,QAAQ,KAAK;;;;GAIhB;GAGD;IACE,MAAM;IACN,UAAU;;;;;;;;;GASX;GAGD;IACE,MAAM;IACN,UAAU;;;;;;;;GAQX;GAGD;IACE,MAAM;IACN,UAAU;;;;;;;;;;;;;;;;;;;;GAoBX;GAGD;IACE,MAAM;IACN,UAAU;;;;;;;;;;;;;GAaX;EACF;AAGD,MAAI,QAAQ,UACV,OAAM,KAAK;GACT,MAAM;GACN,UAAU;;;;;;;;EAQX,EAAC;AAGJ,SAAO;CACR;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/cli",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "CLI tools for building Lambda handlers, server applications, and generating OpenAPI specs",
   "private": false,
   "type": "module",
@@ -10,6 +10,11 @@
       "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
     },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.mjs",
+      "require": "./dist/config.cjs"
+    },
     "./openapi": {
       "types": "./dist/openapi.d.ts",
       "import": "./dist/openapi.mjs",
@@ -32,20 +37,23 @@
     "@apidevtools/swagger-parser": "^10.1.0",
     "chokidar": "~4.0.3",
     "commander": "^12.1.0",
+    "dotenv": "~17.2.3",
     "fast-glob": "^3.3.2",
     "lodash.kebabcase": "^4.1.1",
-    "openapi-typescript": "^7.4.2"
+    "openapi-typescript": "^7.4.2",
+    "prompts": "~2.4.2"
   },
   "devDependencies": {
     "@types/lodash.kebabcase": "^4.1.9",
     "@types/node": "~24.9.1",
+    "@types/prompts": "~2.4.9",
     "typescript": "^5.8.2",
     "vitest": "^3.2.4",
     "zod": "~4.1.13",
     "@geekmidas/testkit": "0.0.17"
   },
   "peerDependencies": {
-    "@geekmidas/constructs": "~0.1.0",
+    "@geekmidas/constructs": "~0.2.0",
     "@geekmidas/envkit": "~0.1.0",
     "@geekmidas/logger": "~0.0.1",
     "@geekmidas/telescope": "~0.0.1",

package/src/__tests__/loadEnvFiles.spec.ts

@@ -0,0 +1,131 @@
+import { existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { loadEnvFiles } from '../dev';
+
+describe('loadEnvFiles', () => {
+  let testDir: string;
+  const originalEnv = { ...process.env };
+
+  beforeEach(() => {
+    // Create a temporary test directory
+    testDir = join(tmpdir(), `gkm-test-${Date.now()}`);
+    mkdirSync(testDir, { recursive: true });
+
+    // Reset process.env to original state
+    process.env = { ...originalEnv };
+  });
+
+  afterEach(() => {
+    // Clean up test directory
+    if (existsSync(testDir)) {
+      rmSync(testDir, { recursive: true, force: true });
+    }
+
+    // Reset process.env
+    process.env = originalEnv;
+  });
+
+  it('should load a single .env file', () => {
+    writeFileSync(join(testDir, '.env'), 'TEST_VAR=hello\nANOTHER_VAR=world');
+
+    const { loaded, missing } = loadEnvFiles('.env', testDir);
+
+    expect(loaded).toEqual(['.env']);
+    expect(missing).toEqual([]);
+    expect(process.env.TEST_VAR).toBe('hello');
+    expect(process.env.ANOTHER_VAR).toBe('world');
+  });
+
+  it('should load multiple env files in order', () => {
+    writeFileSync(join(testDir, '.env'), 'VAR1=base\nVAR2=base');
+    writeFileSync(join(testDir, '.env.local'), 'VAR2=local\nVAR3=local');
+
+    const { loaded, missing } = loadEnvFiles(['.env', '.env.local'], testDir);
+
+    expect(loaded).toEqual(['.env', '.env.local']);
+    expect(missing).toEqual([]);
+    expect(process.env.VAR1).toBe('base');
+    expect(process.env.VAR2).toBe('local'); // Overridden by .env.local
+    expect(process.env.VAR3).toBe('local');
+  });
+
+  it('should report missing files when explicitly configured', () => {
+    writeFileSync(join(testDir, '.env'), 'VAR=value');
+
+    const { loaded, missing } = loadEnvFiles(
+      ['.env', '.env.local', '.env.missing'],
+      testDir,
+    );
+
+    expect(loaded).toEqual(['.env']);
+    expect(missing).toEqual(['.env.local', '.env.missing']);
+    expect(process.env.VAR).toBe('value');
+  });
+
+  it('should not report missing .env when using default', () => {
+    // No .env file exists
+    const { loaded, missing } = loadEnvFiles(undefined, testDir);
+
+    expect(loaded).toEqual([]);
+    expect(missing).toEqual([]);
+  });
+
+  it('should handle undefined config with default .env', () => {
+    writeFileSync(join(testDir, '.env'), 'DEFAULT_VAR=default');
+
+    const { loaded, missing } = loadEnvFiles(undefined, testDir);
+
+    expect(loaded).toEqual(['.env']);
+    expect(missing).toEqual([]);
+    expect(process.env.DEFAULT_VAR).toBe('default');
+  });
+
+  it('should handle string config as single file', () => {
+    writeFileSync(join(testDir, '.env.production'), 'PROD_VAR=production');
+
+    const { loaded, missing } = loadEnvFiles('.env.production', testDir);
+
+    expect(loaded).toEqual(['.env.production']);
+    expect(missing).toEqual([]);
+    expect(process.env.PROD_VAR).toBe('production');
+  });
+
+  it('should override earlier files with later files', () => {
+    writeFileSync(join(testDir, '.env'), 'SHARED=first\nONLY_FIRST=yes');
+    writeFileSync(join(testDir, '.env.local'), 'SHARED=second');
+    writeFileSync(join(testDir, '.env.dev'), 'SHARED=third\nONLY_DEV=yes');
+
+    const { loaded } = loadEnvFiles(
+      ['.env', '.env.local', '.env.dev'],
+      testDir,
+    );
+
+    expect(loaded).toEqual(['.env', '.env.local', '.env.dev']);
+    expect(process.env.SHARED).toBe('third');
+    expect(process.env.ONLY_FIRST).toBe('yes');
+    expect(process.env.ONLY_DEV).toBe('yes');
+  });
+
+  it('should handle empty env files', () => {
+    writeFileSync(join(testDir, '.env'), '');
+
+    const { loaded, missing } = loadEnvFiles('.env', testDir);
+
+    expect(loaded).toEqual(['.env']);
+    expect(missing).toEqual([]);
+  });
+
+  it('should handle env files with comments', () => {
+    writeFileSync(
+      join(testDir, '.env'),
+      '# This is a comment\nVAR=value\n# Another comment',
+    );
+
+    const { loaded } = loadEnvFiles('.env', testDir);
+
+    expect(loaded).toEqual(['.env']);
+    expect(process.env.VAR).toBe('value');
+  });
+});

package/src/build/index.ts

@@ -4,7 +4,8 @@ import type { Cron } from '@geekmidas/constructs/crons';
 import type { Endpoint } from '@geekmidas/constructs/endpoints';
 import type { Function } from '@geekmidas/constructs/functions';
 import type { Subscriber } from '@geekmidas/constructs/subscribers';
-import { loadConfig } from '../config';
+import { loadConfig, parseModuleConfig } from '../config';
+import { normalizeTelescopeConfig } from '../dev';
 import {
   CronGenerator,
   EndpointGenerator,
@@ -42,27 +43,24 @@ export async function buildCommand(options: BuildOptions): Promise<void> {
   }
   logger.log(`Using envParser: ${config.envParser}`);
 
-  // Parse envParser configuration
-  const [envParserPath, envParserName] = config.envParser.split('#');
-  const envParserImportPattern = !envParserName
-    ? 'envParser'
-    : envParserName === 'envParser'
-      ? '{ envParser }'
-      : `{ ${envParserName} as envParser }`;
-
-  // Parse logger configuration
-  const [loggerPath, loggerName] = config.logger.split('#');
-  const loggerImportPattern = !loggerName
-    ? 'logger'
-    : loggerName === 'logger'
-      ? '{ logger }'
-      : `{ ${loggerName} as logger }`;
+  // Parse envParser and logger configuration
+  const { path: envParserPath, importPattern: envParserImportPattern } =
+    parseModuleConfig(config.envParser, 'envParser');
+  const { path: loggerPath, importPattern: loggerImportPattern } =
+    parseModuleConfig(config.logger, 'logger');
+
+  // Normalize telescope configuration
+  const telescope = normalizeTelescopeConfig(config.telescope);
+  if (telescope) {
+    logger.log(`🔭 Telescope enabled at ${telescope.path}`);
+  }
 
   const buildContext: BuildContext = {
     envParserPath,
     envParserImportPattern,
     loggerPath,
     loggerImportPattern,
+    telescope,
   };
 
   // Initialize generators

package/src/build/types.ts

@@ -26,6 +26,11 @@ export interface ProcessedCron {
 
 export interface NormalizedTelescopeConfig {
   enabled: boolean;
+  /** Path to user's telescope module (if provided) */
+  telescopePath?: string;
+  /** Import pattern for telescope (e.g., '{ telescope }' or 'telescope') */
+  telescopeImportPattern?: string;
+  /** UI path for telescope dashboard */
   path: string;
   ignore: string[];
   recordBody: boolean;

package/src/config.ts

@@ -2,6 +2,63 @@ import { existsSync } from 'fs';
 import { join } from 'path';
 import type { GkmConfig } from './types.ts';
 
+/**
+ * Define GKM configuration with full TypeScript support.
+ * This is an identity function that provides type safety and autocomplete.
+ *
+ * @example
+ * ```ts
+ * // gkm.config.ts
+ * import { defineConfig } from '@geekmidas/cli/config';
+ *
+ * export default defineConfig({
+ *   routes: './src/endpoints/**\/*.ts',
+ *   envParser: './src/config/env',
+ *   logger: './src/config/logger',
+ *   telescope: true,
+ * });
+ * ```
+ */
+export function defineConfig(config: GkmConfig): GkmConfig {
+  return config;
+}
+
+export interface ParsedModuleConfig {
+  path: string;
+  importPattern: string;
+}
+
+/**
+ * Parse a module config string into path and import pattern.
+ *
+ * @param configString - Config string in format "./path/to/module" or "./path/to/module#exportName"
+ * @param defaultAlias - The default alias name to use if no export name specified
+ * @returns Object with path and import pattern
+ *
+ * @example
+ * parseModuleConfig('./src/config/env', 'envParser')
+ * // { path: './src/config/env', importPattern: 'envParser' }
+ *
+ * parseModuleConfig('./src/config/env#envParser', 'envParser')
+ * // { path: './src/config/env', importPattern: '{ envParser }' }
+ *
+ * parseModuleConfig('./src/config/env#myEnv', 'envParser')
+ * // { path: './src/config/env', importPattern: '{ myEnv as envParser }' }
+ */
+export function parseModuleConfig(
+  configString: string,
+  defaultAlias: string,
+): ParsedModuleConfig {
+  const [path, exportName] = configString.split('#');
+  const importPattern = !exportName
+    ? defaultAlias
+    : exportName === defaultAlias
+      ? `{ ${defaultAlias} }`
+      : `{ ${exportName} as ${defaultAlias} }`;
+
+  return { path, importPattern };
+}
+
 export async function loadConfig(
   cwd: string = process.cwd(),
 ): Promise<GkmConfig> {