@http-forge/core 0.2.17 → 0.3.0

package/README.md

@@ -563,13 +563,50 @@ The core library includes full OpenAPI 3.0.3 import and export with constraint p
 
 **Export** (`OpenApiExporter`):
 - Generates OpenAPI 3.0.3 specs from collections
+- **Host-variable server resolution** — Any `{{varName}}` that prefixes a request URL (e.g. `{{dcqHost}}/api/...`) is stripped from the path and resolved to a server URL entry. If the variable resolves in the active environment(s), a concrete `url` is added to `servers`. If unresolvable, an OAS server-variable entry is emitted: `url: '{varName}', variables: { varName: { default: '' } }`. This handles arbitrary host variables beyond `{{baseUrl}}`.
+- **Environment variable placeholder sanitization** — `{{varName}}` tokens in parameter examples (path, query, header) and request body examples are replaced with `<varName>` so the exported spec contains readable human placeholders rather than raw template syntax.
 - **Collision-aware merging**: When multiple requests normalize to the same path + HTTP method, they are merged into a single operation:
   - Descriptions are appended, tags are unioned
   - Parameters with the **same constraint kind** (both enum, both pattern, etc.) are merged in-place (union enum values, widen numeric ranges, alternation-join patterns)
   - Parameters with **different constraint kinds** are wrapped in `oneOf` — each variant keeps its self-consistent schema
 - All constraint fields round-trip without data loss
 
-## 🛠️ Use Cases
+## � Exported Types
+
+### Configuration
+
+`HttpForgeConfig` is the shape of `http-forge.config.json`. Key sub-interfaces:
+
+| Interface | Description |
+|---|---|
+| `StorageConfig` | Root/history/results paths |
+| `RequestConfig` | Timeout, redirects, SSL |
+| `ScriptsConfig` | Module search paths |
+| `RunnerConfig` | Retention, index page size |
+| `EnvironmentsConfig` | Default environment |
+| `RestClientExportConfig` | REST Client export path/merge settings |
+| `McpConfig` | MCP server project-level settings (see below) |
+| `ProxyConfig` | HTTP/HTTPS proxy URLs |
+
+**`McpConfig`** — controls what the HTTP Forge MCP server exposes to AI agents. All fields are optional; the service fills defaults automatically via `IConfigService.getMcpConfig()`.
+
+```typescript
+interface McpConfig {
+    excludedCollections: string[];  // IDs or names to hide (default: [] = expose all)
+    excludedSuites:      string[];  // IDs or names to hide (default: [] = expose all)
+    toolPrefix:          string;    // Prefix for every tool name (default: "")
+    maxRequestsPerCall:  number;    // Safety cap per collection/suite call (default: 50)
+    cors: {
+        allowedOrigins:  string[];  // CORS origins (default: ["http://localhost","http://127.0.0.1"])
+    };
+}
+```
+
+Use `IConfigService.getMcpConfig()` to read the resolved config with all defaults applied.
+
+---
+
+## �🛠️ Use Cases
 
 ### CLI Tool
 
@@ -767,6 +804,11 @@ MIT © Henry Huang
 - ✅ **`duplicateFolder(collectionId, folderId, newName)`** — Duplicates a folder within a collection, preserving all nested request content
 - ✅ **`getItemPath(collectionId, itemId)`** — Resolves the disk path of a folder or request within a collection
 
+### 0.2.6 (OpenAPI Export — Environment Variable Handling)
+
+- ✅ **Host-variable URL stripping** — Any leading `{{varName}}` in a request URL (e.g. `{{dcqHost}}/DCQ/templates/GetEpg`) is now correctly stripped from the path. The variable name is resolved via `envConfigService.resolveVariables()` and the resulting URL is added to `servers`. When the variable cannot be resolved, an OAS server-variable entry (`url: '{varName}', variables: { varName: { default: '' } }`) is emitted instead. Previously, unknown host variables were converted to `/{varName}/...` path segments.
+- ✅ **Example sanitization** — `{{varName}}` placeholders in parameter examples (path, query, header) and request body examples are replaced with `<varName>` so they render as readable human placeholders instead of raw template syntax in the exported spec.
+
 ### 0.2.5 (OpenAPI Constraint Round-Trip & Collision Merging)
 
 - ✅ **Full parameter constraint round-trip** — OpenAPI import/export now preserves all schema constraint fields: `pattern`, `minimum`, `maximum`, `exclusiveMinimum`, `exclusiveMaximum`, `minLength`, `maxLength`, and `oneOf` on both `KeyValueEntry` and `PathParamEntry`

package/dist/index.d.ts

@@ -93,7 +93,8 @@ export { ExampleGenerator, HistoryAnalyzer, OpenApiExporter, OpenApiImporter, Re
 export type { OpenApiExportOptions, OpenApiImportOptions, ScriptAnalysisResult } from './infrastructure/openapi';
 export * from './infrastructure/openapi/interfaces';
 export { CONFIG_FILES, ConfigService, DEFAULT_CONFIG, ROOT_DIRECTORIES } from './infrastructure/config';
-export type { EnvironmentsConfig, HttpForgeConfig, IConfigService, ProxyConfig, RequestConfig, RestClientExportConfig, RunnerConfig, ScriptsConfig, StorageConfig } from './infrastructure/config';
+export type { EnvironmentsConfig, HttpForgeConfig, IConfigService, McpConfig, McpCorsConfig, ProxyConfig, RequestConfig, RestClientExportConfig, RunnerConfig, ScriptsConfig, StorageConfig } from './infrastructure/config';
+export { HtmlReportGenerator } from './infrastructure/test-suite/html-report-generator';
 export { DEFAULT_SUITE_CONFIG } from './infrastructure/test-suite/interfaces';
 export type { ErrorSummary, IStatisticsService, ITestSuiteService, RequestStatistics, RunStatistics, RunSummary, SuiteConfig, SuiteRequest, TestSuite } from './infrastructure/test-suite/interfaces';
 export { buildResultFileName, expandSummary, HTTP_METHOD_MAP, HTTP_METHOD_REVERSE } from './infrastructure/test-suite/result-storage';