@geekmidas/cli 0.3.0 → 0.4.0

package/dist/{EndpointGenerator-C73wNoih.cjs → EndpointGenerator-BxNCkus4.cjs}

@@ -80,7 +80,7 @@ var EndpointGenerator = class extends require_Generator.ConstructGenerator {
 		await (0, node_fs_promises.writeFile)(handlerPath, content);
 		return handlerPath;
 	}
-	async generateEndpointsFile(outputDir, endpoints, context) {
+	async generateEndpointsFile(outputDir, endpoints, _context) {
 		const endpointsFileName = "endpoints.ts";
 		const endpointsPath = (0, node_path.join)(outputDir, endpointsFileName);
 		const importsByFile = /* @__PURE__ */ new Map();
@@ -136,6 +136,59 @@ export function setupEndpoints(
 		const appPath = (0, node_path.join)(outputDir, appFileName);
 		const relativeLoggerPath = (0, node_path.relative)((0, node_path.dirname)(appPath), context.loggerPath);
 		const relativeEnvParserPath = (0, node_path.relative)((0, node_path.dirname)(appPath), context.envParserPath);
+		const telescopeEnabled = context.telescope?.enabled;
+		const telescopeWebSocketEnabled = context.telescope?.websocket;
+		const telescopeImports = telescopeEnabled ? `import { Telescope, InMemoryStorage } from '@geekmidas/telescope';
+import { createMiddleware, createUI } from '@geekmidas/telescope/hono';` : "";
+		const telescopeWebSocketSetupCode = telescopeWebSocketEnabled ? `
+  // Setup WebSocket for real-time telescope updates
+  try {
+    const { createNodeWebSocket } = await import('@hono/node-ws');
+    const { injectWebSocket, upgradeWebSocket } = createNodeWebSocket({ app: honoApp });
+    // Add WebSocket route directly to main app (sub-app routes don't support WS upgrade)
+    honoApp.get('${context.telescope.path}/ws', upgradeWebSocket(() => ({
+      onOpen: (_event: Event, ws: any) => {
+        telescope.addWsClient(ws);
+      },
+      onClose: (_event: Event, ws: any) => {
+        telescope.removeWsClient(ws);
+      },
+      onMessage: (event: MessageEvent, ws: any) => {
+        try {
+          const data = JSON.parse(event.data);
+          if (data.type === 'ping') {
+            ws.send(JSON.stringify({ type: 'pong' }));
+          }
+        } catch {
+          // Ignore invalid messages
+        }
+      },
+    })));
+    // Store injectWebSocket for server entry to call after serve()
+    (honoApp as any).__injectWebSocket = injectWebSocket;
+    logger.info('Telescope WebSocket enabled');
+  } catch (e) {
+    logger.warn({ error: e }, 'WebSocket support not available - install @hono/node-ws for real-time updates');
+  }
+` : "";
+		const telescopeSetup = telescopeEnabled ? `
+  // Setup Telescope for debugging/monitoring
+  const telescopeStorage = new InMemoryStorage({ maxEntries: ${context.telescope.maxEntries} });
+  const telescope = new Telescope({
+    enabled: true,
+    path: '${context.telescope.path}',
+    ignorePatterns: ${JSON.stringify(context.telescope.ignore)},
+    recordBody: ${context.telescope.recordBody},
+    storage: telescopeStorage,
+  });
+${telescopeWebSocketSetupCode}
+  // Add telescope middleware (before endpoints to capture all requests)
+  honoApp.use('*', createMiddleware(telescope));
+
+  // Mount telescope UI
+  const telescopeUI = createUI(telescope);
+  honoApp.route('${context.telescope.path}', telescopeUI);
+` : "";
 		const content = `/**
  * Generated server application
  *
@@ -149,6 +202,7 @@ import { setupEndpoints } from './endpoints.js';
 import { setupSubscribers } from './subscribers.js';
 import ${context.envParserImportPattern} from '${relativeEnvParserPath}';
 import ${context.loggerImportPattern} from '${relativeLoggerPath}';
+${telescopeImports}
 
 export interface ServerApp {
   app: HonoType;
@@ -169,7 +223,7 @@ export interface ServerApp {
  * // With Bun
  * import { createApp } from './.gkm/server/app.js';
  *
- * const { app, start } = createApp();
+ * const { app, start } = await createApp();
  *
  * await start({
  *   port: 3000,
@@ -183,7 +237,7 @@ export interface ServerApp {
  * import { serve } from '@hono/node-server';
  * import { createApp } from './.gkm/server/app.js';
  *
- * const { app, start } = createApp();
+ * const { app, start } = await createApp();
  *
  * await start({
  *   port: 3000,
@@ -192,9 +246,9 @@ export interface ServerApp {
  *   }
  * });
  */
-export function createApp(app?: HonoType, enableOpenApi: boolean = true): ServerApp {
+export async function createApp(app?: HonoType, enableOpenApi: boolean = true): Promise<ServerApp> {
   const honoApp = app || new Hono();
-
+${telescopeSetup}
   // Setup HTTP endpoints
   setupEndpoints(honoApp, envParser, logger, enableOpenApi);
 
@@ -268,4 +322,4 @@ Object.defineProperty(exports, 'EndpointGenerator', {
     return EndpointGenerator;
   }
 });
-//# sourceMappingURL=EndpointGenerator-C73wNoih.cjs.map
+//# sourceMappingURL=EndpointGenerator-BxNCkus4.cjs.map

package/dist/EndpointGenerator-BxNCkus4.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointGenerator-BxNCkus4.cjs","names":["ConstructGenerator","value: any","context: BuildContext","constructs: GeneratedConstruct<\n      Endpoint<\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any\n      >\n    >[]","outputDir: string","options?: GeneratorOptions","routes: RouteInfo[]","routeInfo: RouteInfo","sourceFile: string","exportName: string","provider: LegacyProvider","_endpoint: Endpoint<\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any\n    >","content: string","endpoints: GeneratedConstruct<\n      Endpoint<\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any\n      >\n    >[]","_context: BuildContext","exports","importPath: string","envParserPath: string","envParserImportPattern: string"],"sources":["../src/generators/EndpointGenerator.ts"],"sourcesContent":["import { mkdir, writeFile } from 'node:fs/promises';\nimport { dirname, join, relative } from 'node:path';\nimport { Endpoint } from '@geekmidas/constructs/endpoints';\nimport type { BuildContext } from '../build/types';\nimport type { LegacyProvider, RouteInfo } from '../types';\nimport {\n  ConstructGenerator,\n  type GeneratedConstruct,\n  type GeneratorOptions,\n} from './Generator';\n\nexport class EndpointGenerator extends ConstructGenerator<\n  Endpoint<\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any\n  >,\n  RouteInfo[]\n> {\n  isConstruct(\n    value: any,\n  ): value is Endpoint<\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any\n  > {\n    return Endpoint.isEndpoint(value);\n  }\n\n  async build(\n    context: BuildContext,\n    constructs: GeneratedConstruct<\n      Endpoint<\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any\n      >\n    >[],\n    outputDir: string,\n    options?: GeneratorOptions,\n  ): Promise<RouteInfo[]> {\n    const provider = options?.provider || 'aws-apigatewayv2';\n    const enableOpenApi = options?.enableOpenApi || false;\n    const logger = console;\n    const routes: RouteInfo[] = [];\n\n    if (constructs.length === 0) {\n      return routes;\n    }\n\n    if (provider === 'server') {\n      // Generate endpoints.ts and app.ts\n      await this.generateEndpointsFile(outputDir, constructs, context);\n      const appFile = await this.generateAppFile(outputDir, context);\n\n      routes.push({\n        path: '*',\n        method: 'ALL',\n        handler: relative(process.cwd(), appFile),\n        authorizer: 'none',\n      });\n\n      logger.log(\n        `Generated server with ${constructs.length} endpoints${enableOpenApi ? ' (OpenAPI enabled)' : ''}`,\n      );\n    } else if (provider === 'aws-lambda') {\n      // For aws-lambda, create routes subdirectory\n      const routesDir = join(outputDir, 'routes');\n      await mkdir(routesDir, { recursive: true });\n\n      // Generate individual handlers for API Gateway routes\n      for (const { key, construct, path } of constructs) {\n        const handlerFile = await this.generateHandlerFile(\n          routesDir,\n          path.relative,\n          key,\n          'aws-apigatewayv2',\n          construct,\n          context,\n        );\n\n        const routeInfo: RouteInfo = {\n          path: construct._path,\n          method: construct.method,\n          handler: relative(process.cwd(), handlerFile).replace(\n            /\\.ts$/,\n            '.handler',\n          ),\n          timeout: construct.timeout,\n          memorySize: construct.memorySize,\n          environment: await construct.getEnvironment(),\n          authorizer: construct.authorizer?.name ?? 'none',\n        };\n\n        routes.push(routeInfo);\n        logger.log(\n          `Generated handler for ${routeInfo.method} ${routeInfo.path}`,\n        );\n      }\n    } else {\n      // Generate individual handler files for AWS API Gateway providers\n      for (const { key, construct, path } of constructs) {\n        const handlerFile = await this.generateHandlerFile(\n          outputDir,\n          path.relative,\n          key,\n          provider,\n          construct,\n          context,\n        );\n\n        const routeInfo: RouteInfo = {\n          path: construct._path,\n          method: construct.method,\n          handler: relative(process.cwd(), handlerFile).replace(\n            /\\.ts$/,\n            '.handler',\n          ),\n          timeout: construct.timeout,\n          memorySize: construct.memorySize,\n          environment: await construct.getEnvironment(),\n          authorizer: construct.authorizer?.name ?? 'none',\n        };\n\n        routes.push(routeInfo);\n        logger.log(\n          `Generated handler for ${routeInfo.method} ${routeInfo.path}`,\n        );\n      }\n    }\n\n    return routes;\n  }\n\n  private async generateHandlerFile(\n    outputDir: string,\n    sourceFile: string,\n    exportName: string,\n    provider: LegacyProvider,\n    _endpoint: Endpoint<\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any\n    >,\n    context: BuildContext,\n  ): Promise<string> {\n    const handlerFileName = `${exportName}.ts`;\n    const handlerPath = join(outputDir, handlerFileName);\n\n    const relativePath = relative(dirname(handlerPath), sourceFile);\n    const importPath = relativePath.replace(/\\.ts$/, '.js');\n\n    const relativeEnvParserPath = relative(\n      dirname(handlerPath),\n      context.envParserPath,\n    );\n\n    let content: string;\n\n    switch (provider) {\n      case 'aws-apigatewayv1':\n        content = this.generateAWSApiGatewayV1Handler(\n          importPath,\n          exportName,\n          relativeEnvParserPath,\n          context.envParserImportPattern,\n        );\n        break;\n      case 'aws-apigatewayv2':\n        content = this.generateAWSApiGatewayV2Handler(\n          importPath,\n          exportName,\n          relativeEnvParserPath,\n          context.envParserImportPattern,\n        );\n        break;\n      case 'server':\n        content = this.generateServerHandler(importPath, exportName);\n        break;\n      default:\n        throw new Error(`Unsupported provider: ${provider}`);\n    }\n\n    await writeFile(handlerPath, content);\n    return handlerPath;\n  }\n\n  private async generateEndpointsFile(\n    outputDir: string,\n    endpoints: GeneratedConstruct<\n      Endpoint<\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any\n      >\n    >[],\n    _context: BuildContext,\n  ): Promise<string> {\n    const endpointsFileName = 'endpoints.ts';\n    const endpointsPath = join(outputDir, endpointsFileName);\n\n    // Group imports by file\n    const importsByFile = new Map<string, string[]>();\n\n    for (const { path, key } of endpoints) {\n      const relativePath = relative(dirname(endpointsPath), path.relative);\n      const importPath = relativePath.replace(/\\.ts$/, '.js');\n\n      if (!importsByFile.has(importPath)) {\n        importsByFile.set(importPath, []);\n      }\n      importsByFile.get(importPath)!.push(key);\n    }\n\n    // Generate import statements\n    const imports = Array.from(importsByFile.entries())\n      .map(\n        ([importPath, exports]) =>\n          `import { ${exports.join(', ')} } from '${importPath}';`,\n      )\n      .join('\\n');\n\n    const allExportNames = endpoints.map(({ key }) => key);\n\n    const content = `import type { EnvironmentParser } from '@geekmidas/envkit';\nimport type { Logger } from '@geekmidas/logger';\nimport { HonoEndpoint } from '@geekmidas/constructs/hono';\nimport { Endpoint } from '@geekmidas/constructs/endpoints';\nimport { ServiceDiscovery } from '@geekmidas/services';\nimport type { Hono } from 'hono';\n${imports}\n\nconst endpoints: Endpoint<any, any, any, any, any, any, any, any, any, any, any, any, any, any>[] = [\n  ${allExportNames.join(',\\n  ')}\n];\n\nexport function setupEndpoints(\n  app: Hono,\n  envParser: EnvironmentParser<any>,\n  logger: Logger,\n  enableOpenApi: boolean = true,\n): void {\n  const serviceDiscovery = ServiceDiscovery.getInstance(\n    logger,\n    envParser\n  );\n\n  // Configure OpenAPI options based on enableOpenApi flag\n  const openApiOptions: any = enableOpenApi ? {\n    docsPath: '/docs',\n    openApiOptions: {\n      title: 'API Documentation',\n      version: '1.0.0',\n      description: 'Generated API documentation'\n    }\n  } : { docsPath: false };\n\n  HonoEndpoint.addRoutes(endpoints, serviceDiscovery, app, openApiOptions);\n}\n`;\n\n    await writeFile(endpointsPath, content);\n\n    return endpointsPath;\n  }\n\n  private async generateAppFile(\n    outputDir: string,\n    context: BuildContext,\n  ): Promise<string> {\n    const appFileName = 'app.ts';\n    const appPath = join(outputDir, appFileName);\n\n    const relativeLoggerPath = relative(dirname(appPath), context.loggerPath);\n\n    const relativeEnvParserPath = relative(\n      dirname(appPath),\n      context.envParserPath,\n    );\n\n    // Generate telescope imports and setup if enabled\n    const telescopeEnabled = context.telescope?.enabled;\n    const telescopeWebSocketEnabled = context.telescope?.websocket;\n    const telescopeImports = telescopeEnabled\n      ? `import { Telescope, InMemoryStorage } from '@geekmidas/telescope';\nimport { createMiddleware, createUI } from '@geekmidas/telescope/hono';`\n      : '';\n\n    const telescopeWebSocketSetupCode = telescopeWebSocketEnabled\n      ? `\n  // Setup WebSocket for real-time telescope updates\n  try {\n    const { createNodeWebSocket } = await import('@hono/node-ws');\n    const { injectWebSocket, upgradeWebSocket } = createNodeWebSocket({ app: honoApp });\n    // Add WebSocket route directly to main app (sub-app routes don't support WS upgrade)\n    honoApp.get('${context.telescope!.path}/ws', upgradeWebSocket(() => ({\n      onOpen: (_event: Event, ws: any) => {\n        telescope.addWsClient(ws);\n      },\n      onClose: (_event: Event, ws: any) => {\n        telescope.removeWsClient(ws);\n      },\n      onMessage: (event: MessageEvent, ws: any) => {\n        try {\n          const data = JSON.parse(event.data);\n          if (data.type === 'ping') {\n            ws.send(JSON.stringify({ type: 'pong' }));\n          }\n        } catch {\n          // Ignore invalid messages\n        }\n      },\n    })));\n    // Store injectWebSocket for server entry to call after serve()\n    (honoApp as any).__injectWebSocket = injectWebSocket;\n    logger.info('Telescope WebSocket enabled');\n  } catch (e) {\n    logger.warn({ error: e }, 'WebSocket support not available - install @hono/node-ws for real-time updates');\n  }\n`\n      : '';\n\n    const telescopeSetup = telescopeEnabled\n      ? `\n  // Setup Telescope for debugging/monitoring\n  const telescopeStorage = new InMemoryStorage({ maxEntries: ${context.telescope!.maxEntries} });\n  const telescope = new Telescope({\n    enabled: true,\n    path: '${context.telescope!.path}',\n    ignorePatterns: ${JSON.stringify(context.telescope!.ignore)},\n    recordBody: ${context.telescope!.recordBody},\n    storage: telescopeStorage,\n  });\n${telescopeWebSocketSetupCode}\n  // Add telescope middleware (before endpoints to capture all requests)\n  honoApp.use('*', createMiddleware(telescope));\n\n  // Mount telescope UI\n  const telescopeUI = createUI(telescope);\n  honoApp.route('${context.telescope!.path}', telescopeUI);\n`\n      : '';\n\n    const content = `/**\n * Generated server application\n *\n * ⚠️  WARNING: This is for LOCAL DEVELOPMENT ONLY\n * The subscriber polling mechanism is not production-ready.\n * For production, use AWS Lambda with SQS/SNS event sources.\n */\nimport { Hono } from 'hono';\nimport type { Hono as HonoType } from 'hono';\nimport { setupEndpoints } from './endpoints.js';\nimport { setupSubscribers } from './subscribers.js';\nimport ${context.envParserImportPattern} from '${relativeEnvParserPath}';\nimport ${context.loggerImportPattern} from '${relativeLoggerPath}';\n${telescopeImports}\n\nexport interface ServerApp {\n  app: HonoType;\n  start: (options?: {\n    port?: number;\n    serve: (app: HonoType, port: number) => void | Promise<void>;\n  }) => Promise<void>;\n}\n\n/**\n * Create and configure the Hono application\n *\n * @param app - Optional Hono app instance to configure (creates new one if not provided)\n * @param enableOpenApi - Enable OpenAPI documentation (default: true)\n * @returns Server app with configured Hono app and start function\n *\n * @example\n * // With Bun\n * import { createApp } from './.gkm/server/app.js';\n *\n * const { app, start } = await createApp();\n *\n * await start({\n *   port: 3000,\n *   serve: (app, port) => {\n *     Bun.serve({ port, fetch: app.fetch });\n *   }\n * });\n *\n * @example\n * // With Node.js (using @hono/node-server)\n * import { serve } from '@hono/node-server';\n * import { createApp } from './.gkm/server/app.js';\n *\n * const { app, start } = await createApp();\n *\n * await start({\n *   port: 3000,\n *   serve: (app, port) => {\n *     serve({ fetch: app.fetch, port });\n *   }\n * });\n */\nexport async function createApp(app?: HonoType, enableOpenApi: boolean = true): Promise<ServerApp> {\n  const honoApp = app || new Hono();\n${telescopeSetup}\n  // Setup HTTP endpoints\n  setupEndpoints(honoApp, envParser, logger, enableOpenApi);\n\n  return {\n    app: honoApp,\n    async start(options) {\n      if (!options?.serve) {\n        throw new Error(\n          'serve function is required. Pass a serve function for your runtime:\\\\n' +\n          '  - Bun: (app, port) => Bun.serve({ port, fetch: app.fetch })\\\\n' +\n          '  - Node: (app, port) => serve({ fetch: app.fetch, port })'\n        );\n      }\n\n      const port = options.port ?? 3000;\n\n      // Start subscribers in background (non-blocking, local development only)\n      await setupSubscribers(envParser, logger).catch((error) => {\n        logger.error({ error }, 'Failed to start subscribers');\n      });\n\n      logger.info({ port }, 'Starting server');\n\n      // Start HTTP server using provided serve function\n      await options.serve(honoApp, port);\n\n      logger.info({ port }, 'Server started');\n    }\n  };\n}\n\n// Default export for convenience\nexport default createApp;\n`;\n\n    await writeFile(appPath, content);\n\n    return appPath;\n  }\n\n  private generateAWSApiGatewayV1Handler(\n    importPath: string,\n    exportName: string,\n    envParserPath: string,\n    envParserImportPattern: string,\n  ): string {\n    return `import { AmazonApiGatewayV1Endpoint } from '@geekmidas/constructs/aws';\nimport { ${exportName} } from '${importPath}';\nimport ${envParserImportPattern} from '${envParserPath}';\n\nconst adapter = new AmazonApiGatewayV1Endpoint(envParser, ${exportName});\n\nexport const handler = adapter.handler;\n`;\n  }\n\n  private generateAWSApiGatewayV2Handler(\n    importPath: string,\n    exportName: string,\n    envParserPath: string,\n    envParserImportPattern: string,\n  ): string {\n    return `import { AmazonApiGatewayV2Endpoint } from '@geekmidas/constructs/aws';\nimport { ${exportName} } from '${importPath}';\nimport ${envParserImportPattern} from '${envParserPath}';\n\nconst adapter = new AmazonApiGatewayV2Endpoint(envParser, ${exportName});\n\nexport const handler = adapter.handler;\n`;\n  }\n\n  private generateServerHandler(\n    importPath: string,\n    exportName: string,\n  ): string {\n    return `import { ${exportName} } from '${importPath}';\n\n// Server handler - implement based on your server framework\nexport const handler = ${exportName};\n`;\n  }\n}\n"],"mappings":"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"}

package/dist/{EndpointGenerator-CWh18d92.mjs → EndpointGenerator-CzDhG7Or.mjs}

@@ -79,7 +79,7 @@ var EndpointGenerator = class extends ConstructGenerator {
 		await writeFile(handlerPath, content);
 		return handlerPath;
 	}
-	async generateEndpointsFile(outputDir, endpoints, context) {
+	async generateEndpointsFile(outputDir, endpoints, _context) {
 		const endpointsFileName = "endpoints.ts";
 		const endpointsPath = join(outputDir, endpointsFileName);
 		const importsByFile = /* @__PURE__ */ new Map();
@@ -135,6 +135,59 @@ export function setupEndpoints(
 		const appPath = join(outputDir, appFileName);
 		const relativeLoggerPath = relative(dirname(appPath), context.loggerPath);
 		const relativeEnvParserPath = relative(dirname(appPath), context.envParserPath);
+		const telescopeEnabled = context.telescope?.enabled;
+		const telescopeWebSocketEnabled = context.telescope?.websocket;
+		const telescopeImports = telescopeEnabled ? `import { Telescope, InMemoryStorage } from '@geekmidas/telescope';
+import { createMiddleware, createUI } from '@geekmidas/telescope/hono';` : "";
+		const telescopeWebSocketSetupCode = telescopeWebSocketEnabled ? `
+  // Setup WebSocket for real-time telescope updates
+  try {
+    const { createNodeWebSocket } = await import('@hono/node-ws');
+    const { injectWebSocket, upgradeWebSocket } = createNodeWebSocket({ app: honoApp });
+    // Add WebSocket route directly to main app (sub-app routes don't support WS upgrade)
+    honoApp.get('${context.telescope.path}/ws', upgradeWebSocket(() => ({
+      onOpen: (_event: Event, ws: any) => {
+        telescope.addWsClient(ws);
+      },
+      onClose: (_event: Event, ws: any) => {
+        telescope.removeWsClient(ws);
+      },
+      onMessage: (event: MessageEvent, ws: any) => {
+        try {
+          const data = JSON.parse(event.data);
+          if (data.type === 'ping') {
+            ws.send(JSON.stringify({ type: 'pong' }));
+          }
+        } catch {
+          // Ignore invalid messages
+        }
+      },
+    })));
+    // Store injectWebSocket for server entry to call after serve()
+    (honoApp as any).__injectWebSocket = injectWebSocket;
+    logger.info('Telescope WebSocket enabled');
+  } catch (e) {
+    logger.warn({ error: e }, 'WebSocket support not available - install @hono/node-ws for real-time updates');
+  }
+` : "";
+		const telescopeSetup = telescopeEnabled ? `
+  // Setup Telescope for debugging/monitoring
+  const telescopeStorage = new InMemoryStorage({ maxEntries: ${context.telescope.maxEntries} });
+  const telescope = new Telescope({
+    enabled: true,
+    path: '${context.telescope.path}',
+    ignorePatterns: ${JSON.stringify(context.telescope.ignore)},
+    recordBody: ${context.telescope.recordBody},
+    storage: telescopeStorage,
+  });
+${telescopeWebSocketSetupCode}
+  // Add telescope middleware (before endpoints to capture all requests)
+  honoApp.use('*', createMiddleware(telescope));
+
+  // Mount telescope UI
+  const telescopeUI = createUI(telescope);
+  honoApp.route('${context.telescope.path}', telescopeUI);
+` : "";
 		const content = `/**
  * Generated server application
  *
@@ -148,6 +201,7 @@ import { setupEndpoints } from './endpoints.js';
 import { setupSubscribers } from './subscribers.js';
 import ${context.envParserImportPattern} from '${relativeEnvParserPath}';
 import ${context.loggerImportPattern} from '${relativeLoggerPath}';
+${telescopeImports}
 
 export interface ServerApp {
   app: HonoType;
@@ -168,7 +222,7 @@ export interface ServerApp {
  * // With Bun
  * import { createApp } from './.gkm/server/app.js';
  *
- * const { app, start } = createApp();
+ * const { app, start } = await createApp();
  *
  * await start({
  *   port: 3000,
@@ -182,7 +236,7 @@ export interface ServerApp {
  * import { serve } from '@hono/node-server';
  * import { createApp } from './.gkm/server/app.js';
  *
- * const { app, start } = createApp();
+ * const { app, start } = await createApp();
  *
  * await start({
  *   port: 3000,
@@ -191,9 +245,9 @@ export interface ServerApp {
  *   }
  * });
  */
-export function createApp(app?: HonoType, enableOpenApi: boolean = true): ServerApp {
+export async function createApp(app?: HonoType, enableOpenApi: boolean = true): Promise<ServerApp> {
   const honoApp = app || new Hono();
-
+${telescopeSetup}
   // Setup HTTP endpoints
   setupEndpoints(honoApp, envParser, logger, enableOpenApi);
 
@@ -262,4 +316,4 @@ export const handler = ${exportName};
 
 //#endregion
 export { EndpointGenerator };
-//# sourceMappingURL=EndpointGenerator-CWh18d92.mjs.map
+//# sourceMappingURL=EndpointGenerator-CzDhG7Or.mjs.map

package/dist/EndpointGenerator-CzDhG7Or.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointGenerator-CzDhG7Or.mjs","names":["value: any","context: BuildContext","constructs: GeneratedConstruct<\n      Endpoint<\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any\n      >\n    >[]","outputDir: string","options?: GeneratorOptions","routes: RouteInfo[]","routeInfo: RouteInfo","sourceFile: string","exportName: string","provider: LegacyProvider","_endpoint: Endpoint<\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any\n    >","content: string","endpoints: GeneratedConstruct<\n      Endpoint<\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any\n      >\n    >[]","_context: BuildContext","importPath: string","envParserPath: string","envParserImportPattern: string"],"sources":["../src/generators/EndpointGenerator.ts"],"sourcesContent":["import { mkdir, writeFile } from 'node:fs/promises';\nimport { dirname, join, relative } from 'node:path';\nimport { Endpoint } from '@geekmidas/constructs/endpoints';\nimport type { BuildContext } from '../build/types';\nimport type { LegacyProvider, RouteInfo } from '../types';\nimport {\n  ConstructGenerator,\n  type GeneratedConstruct,\n  type GeneratorOptions,\n} from './Generator';\n\nexport class EndpointGenerator extends ConstructGenerator<\n  Endpoint<\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any\n  >,\n  RouteInfo[]\n> {\n  isConstruct(\n    value: any,\n  ): value is Endpoint<\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any,\n    any\n  > {\n    return Endpoint.isEndpoint(value);\n  }\n\n  async build(\n    context: BuildContext,\n    constructs: GeneratedConstruct<\n      Endpoint<\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any\n      >\n    >[],\n    outputDir: string,\n    options?: GeneratorOptions,\n  ): Promise<RouteInfo[]> {\n    const provider = options?.provider || 'aws-apigatewayv2';\n    const enableOpenApi = options?.enableOpenApi || false;\n    const logger = console;\n    const routes: RouteInfo[] = [];\n\n    if (constructs.length === 0) {\n      return routes;\n    }\n\n    if (provider === 'server') {\n      // Generate endpoints.ts and app.ts\n      await this.generateEndpointsFile(outputDir, constructs, context);\n      const appFile = await this.generateAppFile(outputDir, context);\n\n      routes.push({\n        path: '*',\n        method: 'ALL',\n        handler: relative(process.cwd(), appFile),\n        authorizer: 'none',\n      });\n\n      logger.log(\n        `Generated server with ${constructs.length} endpoints${enableOpenApi ? ' (OpenAPI enabled)' : ''}`,\n      );\n    } else if (provider === 'aws-lambda') {\n      // For aws-lambda, create routes subdirectory\n      const routesDir = join(outputDir, 'routes');\n      await mkdir(routesDir, { recursive: true });\n\n      // Generate individual handlers for API Gateway routes\n      for (const { key, construct, path } of constructs) {\n        const handlerFile = await this.generateHandlerFile(\n          routesDir,\n          path.relative,\n          key,\n          'aws-apigatewayv2',\n          construct,\n          context,\n        );\n\n        const routeInfo: RouteInfo = {\n          path: construct._path,\n          method: construct.method,\n          handler: relative(process.cwd(), handlerFile).replace(\n            /\\.ts$/,\n            '.handler',\n          ),\n          timeout: construct.timeout,\n          memorySize: construct.memorySize,\n          environment: await construct.getEnvironment(),\n          authorizer: construct.authorizer?.name ?? 'none',\n        };\n\n        routes.push(routeInfo);\n        logger.log(\n          `Generated handler for ${routeInfo.method} ${routeInfo.path}`,\n        );\n      }\n    } else {\n      // Generate individual handler files for AWS API Gateway providers\n      for (const { key, construct, path } of constructs) {\n        const handlerFile = await this.generateHandlerFile(\n          outputDir,\n          path.relative,\n          key,\n          provider,\n          construct,\n          context,\n        );\n\n        const routeInfo: RouteInfo = {\n          path: construct._path,\n          method: construct.method,\n          handler: relative(process.cwd(), handlerFile).replace(\n            /\\.ts$/,\n            '.handler',\n          ),\n          timeout: construct.timeout,\n          memorySize: construct.memorySize,\n          environment: await construct.getEnvironment(),\n          authorizer: construct.authorizer?.name ?? 'none',\n        };\n\n        routes.push(routeInfo);\n        logger.log(\n          `Generated handler for ${routeInfo.method} ${routeInfo.path}`,\n        );\n      }\n    }\n\n    return routes;\n  }\n\n  private async generateHandlerFile(\n    outputDir: string,\n    sourceFile: string,\n    exportName: string,\n    provider: LegacyProvider,\n    _endpoint: Endpoint<\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any,\n      any\n    >,\n    context: BuildContext,\n  ): Promise<string> {\n    const handlerFileName = `${exportName}.ts`;\n    const handlerPath = join(outputDir, handlerFileName);\n\n    const relativePath = relative(dirname(handlerPath), sourceFile);\n    const importPath = relativePath.replace(/\\.ts$/, '.js');\n\n    const relativeEnvParserPath = relative(\n      dirname(handlerPath),\n      context.envParserPath,\n    );\n\n    let content: string;\n\n    switch (provider) {\n      case 'aws-apigatewayv1':\n        content = this.generateAWSApiGatewayV1Handler(\n          importPath,\n          exportName,\n          relativeEnvParserPath,\n          context.envParserImportPattern,\n        );\n        break;\n      case 'aws-apigatewayv2':\n        content = this.generateAWSApiGatewayV2Handler(\n          importPath,\n          exportName,\n          relativeEnvParserPath,\n          context.envParserImportPattern,\n        );\n        break;\n      case 'server':\n        content = this.generateServerHandler(importPath, exportName);\n        break;\n      default:\n        throw new Error(`Unsupported provider: ${provider}`);\n    }\n\n    await writeFile(handlerPath, content);\n    return handlerPath;\n  }\n\n  private async generateEndpointsFile(\n    outputDir: string,\n    endpoints: GeneratedConstruct<\n      Endpoint<\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any\n      >\n    >[],\n    _context: BuildContext,\n  ): Promise<string> {\n    const endpointsFileName = 'endpoints.ts';\n    const endpointsPath = join(outputDir, endpointsFileName);\n\n    // Group imports by file\n    const importsByFile = new Map<string, string[]>();\n\n    for (const { path, key } of endpoints) {\n      const relativePath = relative(dirname(endpointsPath), path.relative);\n      const importPath = relativePath.replace(/\\.ts$/, '.js');\n\n      if (!importsByFile.has(importPath)) {\n        importsByFile.set(importPath, []);\n      }\n      importsByFile.get(importPath)!.push(key);\n    }\n\n    // Generate import statements\n    const imports = Array.from(importsByFile.entries())\n      .map(\n        ([importPath, exports]) =>\n          `import { ${exports.join(', ')} } from '${importPath}';`,\n      )\n      .join('\\n');\n\n    const allExportNames = endpoints.map(({ key }) => key);\n\n    const content = `import type { EnvironmentParser } from '@geekmidas/envkit';\nimport type { Logger } from '@geekmidas/logger';\nimport { HonoEndpoint } from '@geekmidas/constructs/hono';\nimport { Endpoint } from '@geekmidas/constructs/endpoints';\nimport { ServiceDiscovery } from '@geekmidas/services';\nimport type { Hono } from 'hono';\n${imports}\n\nconst endpoints: Endpoint<any, any, any, any, any, any, any, any, any, any, any, any, any, any>[] = [\n  ${allExportNames.join(',\\n  ')}\n];\n\nexport function setupEndpoints(\n  app: Hono,\n  envParser: EnvironmentParser<any>,\n  logger: Logger,\n  enableOpenApi: boolean = true,\n): void {\n  const serviceDiscovery = ServiceDiscovery.getInstance(\n    logger,\n    envParser\n  );\n\n  // Configure OpenAPI options based on enableOpenApi flag\n  const openApiOptions: any = enableOpenApi ? {\n    docsPath: '/docs',\n    openApiOptions: {\n      title: 'API Documentation',\n      version: '1.0.0',\n      description: 'Generated API documentation'\n    }\n  } : { docsPath: false };\n\n  HonoEndpoint.addRoutes(endpoints, serviceDiscovery, app, openApiOptions);\n}\n`;\n\n    await writeFile(endpointsPath, content);\n\n    return endpointsPath;\n  }\n\n  private async generateAppFile(\n    outputDir: string,\n    context: BuildContext,\n  ): Promise<string> {\n    const appFileName = 'app.ts';\n    const appPath = join(outputDir, appFileName);\n\n    const relativeLoggerPath = relative(dirname(appPath), context.loggerPath);\n\n    const relativeEnvParserPath = relative(\n      dirname(appPath),\n      context.envParserPath,\n    );\n\n    // Generate telescope imports and setup if enabled\n    const telescopeEnabled = context.telescope?.enabled;\n    const telescopeWebSocketEnabled = context.telescope?.websocket;\n    const telescopeImports = telescopeEnabled\n      ? `import { Telescope, InMemoryStorage } from '@geekmidas/telescope';\nimport { createMiddleware, createUI } from '@geekmidas/telescope/hono';`\n      : '';\n\n    const telescopeWebSocketSetupCode = telescopeWebSocketEnabled\n      ? `\n  // Setup WebSocket for real-time telescope updates\n  try {\n    const { createNodeWebSocket } = await import('@hono/node-ws');\n    const { injectWebSocket, upgradeWebSocket } = createNodeWebSocket({ app: honoApp });\n    // Add WebSocket route directly to main app (sub-app routes don't support WS upgrade)\n    honoApp.get('${context.telescope!.path}/ws', upgradeWebSocket(() => ({\n      onOpen: (_event: Event, ws: any) => {\n        telescope.addWsClient(ws);\n      },\n      onClose: (_event: Event, ws: any) => {\n        telescope.removeWsClient(ws);\n      },\n      onMessage: (event: MessageEvent, ws: any) => {\n        try {\n          const data = JSON.parse(event.data);\n          if (data.type === 'ping') {\n            ws.send(JSON.stringify({ type: 'pong' }));\n          }\n        } catch {\n          // Ignore invalid messages\n        }\n      },\n    })));\n    // Store injectWebSocket for server entry to call after serve()\n    (honoApp as any).__injectWebSocket = injectWebSocket;\n    logger.info('Telescope WebSocket enabled');\n  } catch (e) {\n    logger.warn({ error: e }, 'WebSocket support not available - install @hono/node-ws for real-time updates');\n  }\n`\n      : '';\n\n    const telescopeSetup = telescopeEnabled\n      ? `\n  // Setup Telescope for debugging/monitoring\n  const telescopeStorage = new InMemoryStorage({ maxEntries: ${context.telescope!.maxEntries} });\n  const telescope = new Telescope({\n    enabled: true,\n    path: '${context.telescope!.path}',\n    ignorePatterns: ${JSON.stringify(context.telescope!.ignore)},\n    recordBody: ${context.telescope!.recordBody},\n    storage: telescopeStorage,\n  });\n${telescopeWebSocketSetupCode}\n  // Add telescope middleware (before endpoints to capture all requests)\n  honoApp.use('*', createMiddleware(telescope));\n\n  // Mount telescope UI\n  const telescopeUI = createUI(telescope);\n  honoApp.route('${context.telescope!.path}', telescopeUI);\n`\n      : '';\n\n    const content = `/**\n * Generated server application\n *\n * ⚠️  WARNING: This is for LOCAL DEVELOPMENT ONLY\n * The subscriber polling mechanism is not production-ready.\n * For production, use AWS Lambda with SQS/SNS event sources.\n */\nimport { Hono } from 'hono';\nimport type { Hono as HonoType } from 'hono';\nimport { setupEndpoints } from './endpoints.js';\nimport { setupSubscribers } from './subscribers.js';\nimport ${context.envParserImportPattern} from '${relativeEnvParserPath}';\nimport ${context.loggerImportPattern} from '${relativeLoggerPath}';\n${telescopeImports}\n\nexport interface ServerApp {\n  app: HonoType;\n  start: (options?: {\n    port?: number;\n    serve: (app: HonoType, port: number) => void | Promise<void>;\n  }) => Promise<void>;\n}\n\n/**\n * Create and configure the Hono application\n *\n * @param app - Optional Hono app instance to configure (creates new one if not provided)\n * @param enableOpenApi - Enable OpenAPI documentation (default: true)\n * @returns Server app with configured Hono app and start function\n *\n * @example\n * // With Bun\n * import { createApp } from './.gkm/server/app.js';\n *\n * const { app, start } = await createApp();\n *\n * await start({\n *   port: 3000,\n *   serve: (app, port) => {\n *     Bun.serve({ port, fetch: app.fetch });\n *   }\n * });\n *\n * @example\n * // With Node.js (using @hono/node-server)\n * import { serve } from '@hono/node-server';\n * import { createApp } from './.gkm/server/app.js';\n *\n * const { app, start } = await createApp();\n *\n * await start({\n *   port: 3000,\n *   serve: (app, port) => {\n *     serve({ fetch: app.fetch, port });\n *   }\n * });\n */\nexport async function createApp(app?: HonoType, enableOpenApi: boolean = true): Promise<ServerApp> {\n  const honoApp = app || new Hono();\n${telescopeSetup}\n  // Setup HTTP endpoints\n  setupEndpoints(honoApp, envParser, logger, enableOpenApi);\n\n  return {\n    app: honoApp,\n    async start(options) {\n      if (!options?.serve) {\n        throw new Error(\n          'serve function is required. Pass a serve function for your runtime:\\\\n' +\n          '  - Bun: (app, port) => Bun.serve({ port, fetch: app.fetch })\\\\n' +\n          '  - Node: (app, port) => serve({ fetch: app.fetch, port })'\n        );\n      }\n\n      const port = options.port ?? 3000;\n\n      // Start subscribers in background (non-blocking, local development only)\n      await setupSubscribers(envParser, logger).catch((error) => {\n        logger.error({ error }, 'Failed to start subscribers');\n      });\n\n      logger.info({ port }, 'Starting server');\n\n      // Start HTTP server using provided serve function\n      await options.serve(honoApp, port);\n\n      logger.info({ port }, 'Server started');\n    }\n  };\n}\n\n// Default export for convenience\nexport default createApp;\n`;\n\n    await writeFile(appPath, content);\n\n    return appPath;\n  }\n\n  private generateAWSApiGatewayV1Handler(\n    importPath: string,\n    exportName: string,\n    envParserPath: string,\n    envParserImportPattern: string,\n  ): string {\n    return `import { AmazonApiGatewayV1Endpoint } from '@geekmidas/constructs/aws';\nimport { ${exportName} } from '${importPath}';\nimport ${envParserImportPattern} from '${envParserPath}';\n\nconst adapter = new AmazonApiGatewayV1Endpoint(envParser, ${exportName});\n\nexport const handler = adapter.handler;\n`;\n  }\n\n  private generateAWSApiGatewayV2Handler(\n    importPath: string,\n    exportName: string,\n    envParserPath: string,\n    envParserImportPattern: string,\n  ): string {\n    return `import { AmazonApiGatewayV2Endpoint } from '@geekmidas/constructs/aws';\nimport { ${exportName} } from '${importPath}';\nimport ${envParserImportPattern} from '${envParserPath}';\n\nconst adapter = new AmazonApiGatewayV2Endpoint(envParser, ${exportName});\n\nexport const handler = adapter.handler;\n`;\n  }\n\n  private generateServerHandler(\n    importPath: string,\n    exportName: string,\n  ): string {\n    return `import { ${exportName} } from '${importPath}';\n\n// Server handler - implement based on your server framework\nexport const handler = ${exportName};\n`;\n  }\n}\n"],"mappings":"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"}