Kraken Explorer

Visualize and navigate NestJS backends built with the Kraken DDD framework. Provides deep insight into module structure, API endpoints, dependencies, and real-time request logging — all from within VS Code.

Features

Module Explorer

Browse all Kraken modules organized by architectural layer:

• Domain - Entities, Schemas
• Application - Use cases
• Infrastructure - Repositories (Mongo / Memory)
• Presentation - Controllers, DTOs, Permissions

Click any file to open it in the editor. Auto-refreshes when files change.

Endpoint Explorer

Lists every API endpoint across your project, grouped by module.

• HTTP method, path, and operation name
• Marks factory-generated endpoints (via createBaseEntityController)
• Shows security requirements and required permissions
• Request/response parameter details with types

Filtering: search by name, filter by module, toggle HTTP methods.

Dependency Graph

Interactive canvas visualization of module dependencies.

• Solid lines for normal imports, dashed lines for forward references
• Hover tooltips, auto-layout, responsive resizing

Open with the command Kraken: Show Module Dependency Graph.

Log Visualizer

Real-time HTTP request log viewer.

• Timestamp, method, URL, status, duration
• Request headers, body, query/path params
• Response body and session details
• Transaction and operation-level tracing (driver, database, model, method)

Reads from .kraken/logs.jsonl — includes setup instructions for the interceptor.

Request Panel

Test endpoints directly from the sidebar.

• Auto-populated body, path params, and query params from DTO parsing
• Custom headers editor
• Copy as URL or cURL
• Shows auth requirements and response schema

Authentication

Built-in auth management:

• Login/logout with email and password
• Saved users for quick switching
• Organization selector
• JWT token inspection and expiry tracking

Code Lens

Inline annotations in your editor:

• Factory controllers show all 10 auto-generated CRUD endpoints
• Permission guard hints
• Route path information

Diagnostics

Inline warnings for common issues:

• Legacy verifyPermissions usage (suggests JwtPermissionGuard)
• Missing verify() method on entities
• Non-standard pagination DTOs
• Deprecated driver usage

Icon Theme

Custom file and folder icons for the Kraken architecture — entities, DTOs, mappers, repositories, use cases, controllers, and more. Auto-activates when krakenconfig.json is detected.

Getting Started

1. Install the extension
2. Open a project that contains a krakenconfig.json file
3. The Kraken Explorer icon appears in the activity bar

Requirements

• VS Code 1.85+
• A NestJS project using the Kraken DDD framework

Commands