nest-graph-inspector 0.2.9 → 0.4.0

package/README.md

@@ -12,21 +12,30 @@
 
 Nest Graph Inspector reads your NestJS runtime container and generates a dependency graph of modules, providers, controllers, and their relationships.
 
-### Result Preview
+### Preview
 
-[**Try the interactive viewer with AI Chat →**](https://albasyir.github.io/nest-graph-inspector/view/) 
+This is a static preview. [**Try the interactive viewer with AI Chat →**](https://albasyir.github.io/nest-graph-inspector/view/) 
 
 > "Load Example" to see result without installing it
 
-## Features
+## Why It Matters
 
-- **Runtime introspection** — graphs are built from the actual Nest container, not static source parsing
-- **Minimal setup** — import the module and you're done
-- **Interactive web viewer** — zoom, pan, and inspect nodes in the browser
-- **Chat with AI** — there's AI that help you to understand complex graph
-- **JSON output** — structured data for programmatic use or CI integration
-- **Markdown output** — AI-friendly graph representation
+Shipping speed depends on confidence. Teams need runtime visibility to trace impact, find architecture issues early, and ship safer changes.
 
+- **Ship Changes Faster** — trace impact in minutes, not meetings, before touching critical providers or modules
+- **Cut Regression Risk** — catch circular and high-coupling patterns before they become release blockers
+- **Make PR Reviews Concrete** — replace assumptions with runtime-backed module and provider-level evidence
+- **Onboard With Real Context** — give new engineers a live map of how the system actually connects and behaves
+- **Find Architecture Issues Early** — use Issue Finder to surface structural problems before they grow into production incidents
+
+## Feature List
+
+- **Dependency Graph** — visualize modules, providers, controllers, imports, and dependency edges from the running app
+- **Circular Detection** — surface circular relationships early so teams can resolve risky loops before release
+- **Relation Focus** — coming soon: focus provider/module pairs to see how they relate and where dependencies connect
+- **Context-Aware AI Assistant** — ask graph and trace questions in plain language with context-aware answers, always free in the viewer
+- **Process Sequence** — coming soon: generate sequence diagrams from an entry point to completion flow
+- **Direct Run** — coming soon: execute runtime-resolved services and functions directly from graph context
 
 ## Quick Start
 
@@ -38,10 +47,10 @@ npm install nest-graph-inspector
 
 ```ts
 import { Module } from '@nestjs/common';
-import { NestGraphInspector } from 'nest-graph-inspector';
+import { NestGraphInspectorModule } from 'nest-graph-inspector';
 
 @Module({
-  imports: [NestGraphInspector],
+  imports: [NestGraphInspectorModule],
 })
 export class RootModule {}
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nest-graph-inspector",
-  "version": "0.2.9",
+  "version": "0.4.0",
   "description": "NestJS module graph inspector for discovery and dependency analysis",
   "license": "MIT",
   "main": "./src/index.js",

package/src/{drivers/file-output.driver.d.ts → adapters/file-output.adapter.d.ts}

@@ -4,7 +4,9 @@ import type { GraphOutput } from '../types/graph-output.type';
 type FileOutputConfig = Extract<NestGraphInspectorOutput, {
     type: 'markdown';
 }>;
-export declare class FileOutputDriver implements OutputAdapter<FileOutputConfig> {
+export declare class FileOutputAdapter implements OutputAdapter<FileOutputConfig> {
+    private readonly markdownTitle;
+    private readonly arrowDirectionDescription;
     private readonly nestCoreModuleName;
     execute(graphOutput: GraphOutput, config: FileOutputConfig): Promise<{
         message: string;
@@ -16,12 +18,25 @@ export declare class FileOutputDriver implements OutputAdapter<FileOutputConfig>
     private appendMermaidProviderRelations;
     private appendMermaidControllerRelations;
     private appendDependencyRelations;
-    private appendLegend;
     private appendModuleSections;
+    private findProviderCircularWarnings;
+    private findControllerCircularWarnings;
+    private findModuleCircularWarnings;
+    private findUnusedImportWarnings;
+    private isModuleImportUsed;
     private appendStringSection;
     private appendProviderSection;
     private appendControllerSection;
     private appendNamedDependencyItem;
+    private appendWarningItems;
+    private appendModuleWarningBlock;
+    private addImportWarning;
+    private providerKey;
+    private providerDisplayName;
+    private providerDisplayNameFromKey;
+    private getOrCreateMap;
+    private getOrCreateArray;
+    private findCircularWarningsFromCycles;
     private toMermaidNodeId;
     private escapeMermaidLabel;
     private moduleGroupId;

package/src/adapters/file-output.adapter.js

@@ -0,0 +1,284 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileOutputAdapter = void 0;
+const promises_1 = require("node:fs/promises");
+const common_1 = require("@nestjs/common");
+const node_path_1 = require("node:path");
+let FileOutputAdapter = class FileOutputAdapter {
+    markdownTitle = 'NestJS Dependency Graph';
+    arrowDirectionDescription = 'Arrow direction: `A --> B` means `A` depends on `B`.';
+    nestCoreModuleName = 'NestJSCoreModule';
+    async execute(graphOutput, config) {
+        const filePath = (0, node_path_1.join)(process.cwd(), config.path);
+        const markdownText = this.buildMarkdownText(graphOutput);
+        await (0, promises_1.mkdir)((0, node_path_1.dirname)(filePath), { recursive: true });
+        await (0, promises_1.writeFile)(filePath, markdownText, 'utf8');
+        return {
+            message: `Graph inspector markdown output was written to ${filePath}`,
+        };
+    }
+    buildMarkdownText(graphOutput) {
+        const lines = [];
+        const moduleEntries = Object.entries(graphOutput.modules);
+        lines.push(`# ${this.markdownTitle}`);
+        lines.push('');
+        lines.push('```mermaid');
+        lines.push('graph TD');
+        lines.push('');
+        this.appendMermaidModuleGroups(lines, moduleEntries);
+        this.appendMermaidModuleRelations(lines, moduleEntries, graphOutput);
+        lines.push('```');
+        lines.push('');
+        lines.push(`> ${this.arrowDirectionDescription}`);
+        lines.push('');
+        this.appendModuleSections(lines, moduleEntries, graphOutput);
+        return lines.join('\n');
+    }
+    appendMermaidModuleGroups(lines, moduleEntries) {
+        for (const [moduleName, moduleData] of moduleEntries) {
+            lines.push(`  subgraph ${this.moduleGroupId(moduleName)}["${this.escapeMermaidLabel(moduleName)}"]`);
+            for (const provider of moduleData.providers) {
+                lines.push(`    ${this.providerNodeId(moduleName, provider.name)}["${this.escapeMermaidLabel(provider.name)}"]`);
+            }
+            for (const controller of moduleData.controllers) {
+                lines.push(`    ${this.controllerNodeId(moduleName, controller.name)}["${this.escapeMermaidLabel(controller.name)}"]`);
+            }
+            lines.push('  end');
+        }
+    }
+    appendMermaidModuleRelations(lines, moduleEntries, graphOutput) {
+        for (const [moduleName, moduleData] of moduleEntries) {
+            this.appendMermaidImportRelations(lines, moduleName, moduleData, graphOutput);
+            this.appendMermaidProviderRelations(lines, moduleName, moduleData, graphOutput);
+            this.appendMermaidControllerRelations(lines, moduleName, moduleData, graphOutput);
+        }
+    }
+    appendMermaidImportRelations(lines, moduleName, moduleData, graphOutput) {
+        const importingModuleGroupId = this.moduleGroupId(moduleName);
+        if (moduleName === this.nestCoreModuleName) {
+            return;
+        }
+        for (const importedModuleName of moduleData.imports) {
+            if (!graphOutput.modules[importedModuleName]) {
+                continue;
+            }
+            const importedModuleGroupId = this.moduleGroupId(importedModuleName);
+            lines.push(`  ${importingModuleGroupId} --> ${importedModuleGroupId}`);
+        }
+    }
+    appendMermaidProviderRelations(lines, moduleName, moduleData, graphOutput) {
+        for (const provider of moduleData.providers) {
+            const providerNodeId = this.providerNodeId(moduleName, provider.name);
+            this.appendDependencyRelations(lines, providerNodeId, moduleName, provider.name, provider.dependencies, graphOutput);
+        }
+    }
+    appendMermaidControllerRelations(lines, moduleName, moduleData, graphOutput) {
+        for (const controller of moduleData.controllers) {
+            const controllerNodeId = this.controllerNodeId(moduleName, controller.name);
+            this.appendDependencyRelations(lines, controllerNodeId, moduleName, controller.name, controller.dependencies, graphOutput);
+        }
+    }
+    appendDependencyRelations(lines, ownerNodeId, moduleName, ownerName, dependencies, graphOutput) {
+        for (const dependency of dependencies) {
+            const dependencyModule = graphOutput.modules[dependency.providedBy.name];
+            const hasDependencyProvider = dependencyModule?.providers.some((provider) => provider.name === dependency.token);
+            if (hasDependencyProvider) {
+                const dependencyProviderNodeId = this.providerNodeId(dependency.providedBy.name, dependency.token);
+                lines.push(`  ${ownerNodeId} --> ${dependencyProviderNodeId}`);
+                continue;
+            }
+            const dependencyLabel = `${dependency.providedBy.name}:${dependency.token}`;
+            const dependencyNodeId = this.dependencyNodeId(moduleName, ownerName, dependencyLabel);
+            lines.push(`  ${dependencyNodeId}["${this.escapeMermaidLabel(dependencyLabel)}"]`);
+            lines.push(`  ${ownerNodeId} --> ${dependencyNodeId}`);
+        }
+    }
+    appendModuleSections(lines, moduleEntries, graphOutput) {
+        const providerCircularWarnings = this.findProviderCircularWarnings(graphOutput);
+        const controllerCircularWarnings = this.findControllerCircularWarnings(graphOutput);
+        const moduleCircularWarnings = this.findModuleCircularWarnings(graphOutput);
+        const unusedImportWarnings = this.findUnusedImportWarnings(moduleEntries, graphOutput);
+        for (const [moduleName, moduleData] of moduleEntries) {
+            lines.push(`## ${moduleName}`);
+            lines.push('');
+            const moduleWarnings = moduleCircularWarnings.get(moduleName);
+            this.appendModuleWarningBlock(lines, moduleWarnings);
+            if (moduleWarnings && moduleWarnings.length > 0) {
+                lines.push('');
+            }
+            this.appendStringSection(lines, 'Imports', moduleData.imports, unusedImportWarnings.get(moduleName));
+            this.appendStringSection(lines, 'Exports', moduleData.exports);
+            this.appendProviderSection(lines, 'Providers', moduleName, moduleData.providers, providerCircularWarnings);
+            this.appendControllerSection(lines, 'Controllers', moduleName, moduleData.controllers, controllerCircularWarnings);
+        }
+    }
+    findProviderCircularWarnings(graphOutput) {
+        return this.findCircularWarningsFromCycles(graphOutput.cycles?.providers, (providerKey) => this.providerDisplayNameFromKey(providerKey));
+    }
+    findControllerCircularWarnings(graphOutput) {
+        return this.findCircularWarningsFromCycles(graphOutput.cycles?.controllers, (controllerKey) => this.providerDisplayNameFromKey(controllerKey));
+    }
+    findModuleCircularWarnings(graphOutput) {
+        return this.findCircularWarningsFromCycles(graphOutput.cycles?.modules, (moduleName) => moduleName);
+    }
+    findUnusedImportWarnings(moduleEntries, graphOutput) {
+        const unusedImportWarnings = new Map();
+        for (const [moduleName, moduleData] of moduleEntries) {
+            if (moduleName === graphOutput.root ||
+                moduleName === this.nestCoreModuleName) {
+                continue;
+            }
+            const dependencies = [
+                ...moduleData.providers.flatMap((provider) => provider.dependencies),
+                ...moduleData.controllers.flatMap((controller) => controller.dependencies),
+            ];
+            for (const importedModuleName of moduleData.imports) {
+                const importedModule = graphOutput.modules[importedModuleName];
+                if (!importedModule) {
+                    continue;
+                }
+                if (this.isModuleImportUsed(moduleData, importedModuleName, importedModule, dependencies)) {
+                    continue;
+                }
+                this.addImportWarning(unusedImportWarnings, moduleName, importedModuleName, 'unused import module');
+            }
+        }
+        return unusedImportWarnings;
+    }
+    isModuleImportUsed(moduleData, importedModuleName, importedModule, dependencies) {
+        if (moduleData.exports.includes(importedModuleName)) {
+            return true;
+        }
+        return dependencies.some((dependency) => {
+            if (dependency.providedBy.name === importedModuleName) {
+                return true;
+            }
+            if (importedModule.exports.includes(dependency.providedBy.name)) {
+                return true;
+            }
+            return importedModule.exports.includes(dependency.token);
+        });
+    }
+    appendStringSection(lines, title, values, warnings = new Map()) {
+        if (values.length === 0) {
+            return;
+        }
+        lines.push(`### ${title}`);
+        for (const value of values) {
+            lines.push(`- ${value}`);
+            this.appendWarningItems(lines, warnings.get(value), '  ');
+        }
+        lines.push('');
+    }
+    appendProviderSection(lines, title, moduleName, providers, circularWarnings) {
+        if (providers.length === 0) {
+            return;
+        }
+        lines.push(`### ${title}`);
+        for (const provider of providers) {
+            this.appendNamedDependencyItem(lines, provider.name, provider.dependencies, circularWarnings.get(this.providerKey(moduleName, provider.name)));
+        }
+        lines.push('');
+    }
+    appendControllerSection(lines, title, moduleName, controllers, circularWarnings) {
+        if (controllers.length === 0) {
+            return;
+        }
+        lines.push(`### ${title}`);
+        for (const controller of controllers) {
+            this.appendNamedDependencyItem(lines, controller.name, controller.dependencies, circularWarnings.get(this.providerKey(moduleName, controller.name)));
+        }
+        lines.push('');
+    }
+    appendNamedDependencyItem(lines, name, dependencies, warnings = []) {
+        lines.push(`- ${name}`);
+        this.appendWarningItems(lines, warnings, '  ');
+        for (const dependency of dependencies) {
+            lines.push(`  - depends on ${dependency.token} from ${dependency.providedBy.name}`);
+        }
+    }
+    appendWarningItems(lines, warnings = [], indent = '') {
+        for (const warning of warnings) {
+            lines.push(`${indent}- Warning: ${warning}`);
+        }
+    }
+    appendModuleWarningBlock(lines, warnings = []) {
+        if (warnings.length === 0) {
+            return;
+        }
+        lines.push('> warnings');
+        for (const warning of warnings) {
+            lines.push(`> - ${warning}`);
+        }
+    }
+    addImportWarning(warnings, moduleName, importedModuleName, warning) {
+        const moduleWarnings = this.getOrCreateMap(warnings, moduleName);
+        const importWarnings = this.getOrCreateArray(moduleWarnings, importedModuleName);
+        importWarnings.push(warning);
+    }
+    providerKey(moduleName, providerName) {
+        return `${moduleName}:${providerName}`;
+    }
+    providerDisplayName(moduleName, providerName) {
+        return `${providerName} from ${moduleName}`;
+    }
+    providerDisplayNameFromKey(providerKey) {
+        const separatorIndex = providerKey.indexOf(':');
+        return this.providerDisplayName(providerKey.slice(0, separatorIndex), providerKey.slice(separatorIndex + 1));
+    }
+    getOrCreateMap(map, key) {
+        const existingValue = map.get(key);
+        if (existingValue) {
+            return existingValue;
+        }
+        const value = new Map();
+        map.set(key, value);
+        return value;
+    }
+    getOrCreateArray(map, key) {
+        const existingValue = map.get(key);
+        if (existingValue) {
+            return existingValue;
+        }
+        const value = [];
+        map.set(key, value);
+        return value;
+    }
+    findCircularWarningsFromCycles(cycles = [], displayName) {
+        const circularWarnings = new Map();
+        for (const cycle of cycles) {
+            const warnings = this.getOrCreateArray(circularWarnings, cycle.from);
+            warnings.push(`${cycle.type} circular dependency with ${displayName(cycle.to)}`);
+        }
+        return circularWarnings;
+    }
+    toMermaidNodeId(value) {
+        return value.replace(/[^a-zA-Z0-9_]/g, '_');
+    }
+    escapeMermaidLabel(value) {
+        return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    }
+    moduleGroupId(moduleName) {
+        return this.toMermaidNodeId(`module-group:${moduleName}`);
+    }
+    providerNodeId(moduleName, providerName) {
+        return this.toMermaidNodeId(`provider:${moduleName}:${providerName}`);
+    }
+    controllerNodeId(moduleName, controllerName) {
+        return this.toMermaidNodeId(`controller:${moduleName}:${controllerName}`);
+    }
+    dependencyNodeId(moduleName, ownerName, dependencyName) {
+        return this.toMermaidNodeId(`dependency:${moduleName}:${ownerName}:${dependencyName}`);
+    }
+};
+exports.FileOutputAdapter = FileOutputAdapter;
+exports.FileOutputAdapter = FileOutputAdapter = __decorate([
+    (0, common_1.Injectable)()
+], FileOutputAdapter);
+//# sourceMappingURL=file-output.adapter.js.map

package/src/adapters/file-output.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-output.adapter.js","sourceRoot":"","sources":["../../../../../libs/nest-graph-inspector/src/adapters/file-output.adapter.ts"],"names":[],"mappings":"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"}

package/src/adapters/http-output.adapter.d.ts

@@ -0,0 +1,25 @@
+import { OutputAdapter } from '../ports/output.adapter';
+import { NestGraphInspectorOutput } from '../nest-graph-inspector.type';
+import type { GraphOutput } from '../types/graph-output.type';
+import { FileOutputAdapter } from './file-output.adapter';
+import { HttpServeAdapter } from './http-serve.adapter';
+type HttpOutputConfig = Extract<NestGraphInspectorOutput, {
+    type: 'http';
+}>;
+interface HttpOutputInternalOptions {
+    httpAdapter?: HttpServeAdapter;
+}
+export declare class HttpOutputAdapter implements OutputAdapter<HttpOutputConfig> {
+    private readonly fileOutputAdapter;
+    private readonly httpServeAdapter;
+    private static readonly inspectorEndpointInfo;
+    static readonly defaultConfig: Readonly<Required<Pick<HttpOutputConfig, 'host' | 'port'>>>;
+    constructor(fileOutputAdapter: FileOutputAdapter, httpServeAdapter: HttpServeAdapter);
+    execute(graphOutput: GraphOutput, config: HttpOutputConfig & HttpOutputInternalOptions): Promise<{
+        message: string;
+    }>;
+    normalizePath(path?: string): string;
+    private get httpOrigin();
+    private joinPath;
+}
+export {};

package/src/adapters/http-output.adapter.js

@@ -0,0 +1,94 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var HttpOutputAdapter_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpOutputAdapter = void 0;
+const common_1 = require("@nestjs/common");
+const file_output_adapter_1 = require("./file-output.adapter");
+const http_serve_adapter_1 = require("./http-serve.adapter");
+let HttpOutputAdapter = class HttpOutputAdapter {
+    static { HttpOutputAdapter_1 = this; }
+    fileOutputAdapter;
+    httpServeAdapter;
+    static inspectorEndpointInfo = {
+        for: 'nest-graph-inspector',
+    };
+    static defaultConfig = {
+        host: 'localhost',
+        port: 53371,
+    };
+    constructor(fileOutputAdapter, httpServeAdapter) {
+        this.fileOutputAdapter = fileOutputAdapter;
+        this.httpServeAdapter = httpServeAdapter;
+    }
+    async execute(graphOutput, config) {
+        const origin = config.origin ?? this.httpOrigin;
+        const path = this.normalizePath(config.path);
+        const informationOutputPath = this.joinPath(path, 'information.json');
+        const jsonOutputPath = this.joinPath(path, 'output.json');
+        const markdownOutputPath = this.joinPath(path, 'output.md');
+        const isReuseHttpAdapter = !!config.httpAdapter;
+        const httpAdapter = config.httpAdapter ?? this.httpServeAdapter;
+        const registration = httpAdapter.register({
+            origin,
+            host: config.host,
+            port: config.port,
+        }, [
+            httpAdapter.get(informationOutputPath, () => HttpOutputAdapter_1.inspectorEndpointInfo, {
+                responseHeaders: {
+                    'content-type': 'application/json; charset=utf-8',
+                },
+            }),
+            httpAdapter.get(jsonOutputPath, () => graphOutput, {
+                responseHeaders: {
+                    'content-type': 'application/json; charset=utf-8',
+                },
+            }),
+            httpAdapter.get(markdownOutputPath, () => this.fileOutputAdapter.buildMarkdownText(graphOutput), {
+                responseHeaders: {
+                    'content-type': 'text/markdown; charset=utf-8',
+                },
+            }),
+        ]);
+        if (!isReuseHttpAdapter) {
+            try {
+                await httpAdapter.serve();
+            }
+            catch (err) {
+                httpAdapter.close(registration.origin);
+                throw err;
+            }
+        }
+        const informationOutputUrl = new URL(informationOutputPath, registration.origin);
+        const jsonOutputUrl = new URL(jsonOutputPath, registration.origin);
+        const markdownOutputUrl = new URL(markdownOutputPath, registration.origin);
+        return {
+            message: `Graph inspector HTTP endpoints are installed at ${informationOutputUrl}, ${jsonOutputUrl}, and ${markdownOutputUrl}`,
+        };
+    }
+    normalizePath(path = '/__nest-graph-inspector') {
+        return path.startsWith('/') ? path : `/${path}`;
+    }
+    get httpOrigin() {
+        const { host, port } = HttpOutputAdapter_1.defaultConfig;
+        return `http://${host}:${port}`;
+    }
+    joinPath(basePath, childPath) {
+        return `${basePath.replace(/\/$/, '')}/${childPath.replace(/^\//, '')}`;
+    }
+};
+exports.HttpOutputAdapter = HttpOutputAdapter;
+exports.HttpOutputAdapter = HttpOutputAdapter = HttpOutputAdapter_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [file_output_adapter_1.FileOutputAdapter,
+        http_serve_adapter_1.HttpServeAdapter])
+], HttpOutputAdapter);
+//# sourceMappingURL=http-output.adapter.js.map

package/src/adapters/http-output.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-output.adapter.js","sourceRoot":"","sources":["../../../../../libs/nest-graph-inspector/src/adapters/http-output.adapter.ts"],"names":[],"mappings":"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"}

package/src/adapters/http-serve.adapter.d.ts

@@ -0,0 +1,58 @@
+import http from 'node:http';
+import { OnModuleDestroy } from '@nestjs/common';
+export type HttpServeOptions = {
+    origin?: string;
+    host?: string;
+    port?: number;
+};
+export type HttpServeRoute = {
+    type: string;
+    path: string;
+    callback?: (context: HttpServeRequest) => unknown | Promise<unknown>;
+    rawCallback?: (req: http.IncomingMessage, res: http.ServerResponse) => void | Promise<void>;
+    requestHeaders?: http.OutgoingHttpHeaders;
+    responseHeaders?: http.OutgoingHttpHeaders;
+    contentType?: string;
+    statusCode?: number;
+};
+export type HttpServeRequest = {
+    request: http.IncomingMessage;
+    headers: http.IncomingHttpHeaders;
+};
+export type HttpServeResponse = {
+    statusCode?: number;
+    contentType?: string;
+    headers?: http.OutgoingHttpHeaders;
+    body?: unknown;
+};
+export declare class HttpServeAdapter implements OnModuleDestroy {
+    private readonly servers;
+    register(options: HttpServeOptions, routes: HttpServeRoute[]): {
+        origin: string;
+    };
+    get(path: string, callback: HttpServeRoute['callback'], options?: Omit<HttpServeRoute, 'type' | 'path' | 'callback'>): HttpServeRoute;
+    post(path: string, callback: HttpServeRoute['callback'], options?: Omit<HttpServeRoute, 'type' | 'path' | 'callback'>): HttpServeRoute;
+    all(path: string, rawCallback: NonNullable<HttpServeRoute['rawCallback']>, options?: Omit<HttpServeRoute, 'type' | 'path' | 'rawCallback'>): HttpServeRoute;
+    serve(): Promise<void>;
+    close(origin?: string): void;
+    onModuleDestroy(): void;
+    private serverState;
+    private serveState;
+    private listen;
+    private handleRequest;
+    private route;
+    private wildcardPathCandidates;
+    private routeKey;
+    private sendResult;
+    private normalizeResponse;
+    private isHttpServeResponse;
+    private serializeBody;
+    private sendText;
+    private requestHeadersMatch;
+    private headerValue;
+    private contentTypeHeader;
+    private setCorsHeaders;
+    private resolveDynamicPort;
+    private normalizeOrigin;
+    private normalizePath;
+}