@http-forge/core 0.3.1 → 0.3.3

package/dist/infrastructure/security/sensitive-data-redactor.d.ts

@@ -16,6 +16,17 @@ import { FullResultDetails } from '../test-suite/result-storage';
  * Returns a shallow copy with sensitive header values replaced.
  */
 export declare function redactHeaders(headers: Record<string, string | string[]>): Record<string, string | string[]>;
+/**
+ * Redact sensitive values from a cookie array.
+ * Cookies with sensitive names have their values replaced.
+ */
+export declare function redactCookies(cookies?: Array<{
+    name?: string;
+    value?: string;
+}>): Array<{
+    name?: string;
+    value?: string;
+}>;
 /**
  * Redact sensitive query parameters from a URL string.
  * E.g. `?token=abc&name=foo` → `?token=[REDACTED]&name=foo`

package/dist/runtime/direct-execution.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Direct Execution APIs
+ *
+ * Execute requests, collections, and suites without requiring MCP server.
+ * Uses shared execution logic from core executors.
+ *
+ * Used by:
+ * - CLI commands (run-request, run-collection, run-suite)
+ * - Third-party Node apps that want to execute HTTP Forge collections programmatically
+ */
+import type { RunCollectionOptions, RunRequestOptions, RunSuiteOptions } from './runtime-contracts';
+/**
+ * Execute a single request without MCP server overhead.
+ * Returns typed result; never calls process.exit.
+ */
+export declare function runRequest(options: RunRequestOptions): Promise<unknown>;
+/**
+ * Execute a collection without MCP server overhead.
+ * Runs all enabled requests in sequence.
+ * Returns typed result; never calls process.exit.
+ */
+export declare function runCollection(options: RunCollectionOptions): Promise<unknown>;
+/**
+ * Execute a test suite without MCP server overhead.
+ * Returns typed result; never calls process.exit.
+ */
+export declare function runSuite(options: RunSuiteOptions): Promise<unknown>;

package/dist/runtime/mcp-runtime.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Embeddable MCP Runtime
+ *
+ * Factory and lifecycle management for MCP runtime that can be embedded in Node.js apps.
+ * Supports:
+ * - In-process tool execution via executeTool()
+ * - Optional lightweight HTTP endpoint for external callers
+ */
+import type { McpRuntimeHandle, McpRuntimeOptions } from './runtime-contracts';
+/**
+ * Create an embeddable MCP runtime instance.
+ *
+ * The returned handle provides lifecycle control and tool execution.
+ * Multiple instances can coexist with different ports and workspaces.
+ *
+ * @param options Configuration for the runtime
+ * @returns Handle for controlling the runtime
+ */
+export declare function createMcpRuntime(options: McpRuntimeOptions): Promise<McpRuntimeHandle>;

package/dist/runtime/node-adapters.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Node.js Platform Adapters
+ *
+ * Implementations of platform abstractions for Node.js environments.
+ * Used by CLI and external third-party Node apps that don't have VS Code context.
+ */
+import type { IFileWatcher, IFileWatcherFactory, IKeyValueStore, INotificationService } from '../types/platform';
+export declare class NodeFileWatcherFactory implements IFileWatcherFactory {
+    createFileWatcher(base: string, glob: string): IFileWatcher;
+}
+export declare class NodeKeyValueStore implements IKeyValueStore {
+    private data;
+    private storeFile;
+    constructor(storePath: string);
+    private load;
+    private save;
+    get<T>(key: string, defaultValue?: T): T | undefined;
+    update(key: string, value: unknown): Promise<void>;
+}
+export declare class NodeNotificationService implements INotificationService {
+    showInformation(message: string): Promise<string | undefined>;
+    showWarning(message: string): Promise<string | undefined>;
+    showError(message: string): Promise<string | undefined>;
+}

package/dist/runtime/node-bootstrap.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Node.js Bootstrap
+ *
+ * Initialize HTTP Forge core services for Node.js environments (CLI, third-party apps).
+ * Provides a factory that creates initialized service containers with Node-specific adapters.
+ */
+import { ServiceContainer } from '../di/service-container';
+export interface NodeBootstrapOptions {
+    /** Workspace root folder path */
+    workspaceFolder: string;
+    /** Optional application info (name, version) */
+    appInfo?: {
+        name: string;
+        version: string;
+    };
+}
+/**
+ * Bootstrap HTTP Forge core services for Node.js environment.
+ * Creates and initializes a service container with Node-native platform adapters.
+ *
+ * @param options Bootstrap configuration
+ * @returns Initialized service container ready for use
+ */
+export declare function bootstrapNodeRuntime(options: NodeBootstrapOptions): ServiceContainer;
+/**
+ * Create and initialize service container for CLI or direct API use.
+ * This is a convenience wrapper that combines bootstrap and returns the container.
+ */
+export declare function createNodeContainer(workspaceFolder: string): ServiceContainer;

package/dist/runtime/runtime-contracts.d.ts

@@ -0,0 +1,125 @@
+/**
+ * HTTP Forge Runtime Contracts
+ *
+ * Public API surface for embeddable MCP runtime and direct execution.
+ * Used by CLI, third-party Node apps, and external integrations.
+ *
+ * Three consumption modes:
+ * 1. Embeddable MCP: createMcpRuntime() + lifecycle handle
+ * 2. Direct execution: runRequest/runCollection/runSuite without MCP
+ * 3. CLI: subcommands that use modes 1 and 2
+ */
+/**
+ * Configuration for creating an embeddable MCP runtime instance.
+ */
+export interface McpRuntimeOptions {
+    /** Workspace root folder path */
+    workspaceFolder: string;
+    /** Port to listen on (default: 3100) */
+    port?: number;
+    /** Host to bind to (default: 127.0.0.1) */
+    host?: string;
+    /** Config field overrides (e.g. { 'mcp.port': 3200 }) */
+    configOverrides?: Record<string, unknown>;
+}
+/**
+ * Handle for controlling an embeddable MCP runtime instance.
+ */
+export interface McpRuntimeHandle {
+    /** Start the MCP server */
+    start(): Promise<void>;
+    /** Stop the MCP server */
+    stop(): Promise<void>;
+    /** Check if server is running */
+    isRunning(): boolean;
+    /** Get the port the server is listening on */
+    getPort(): number;
+    /** Execute a tool in-process (no protocol overhead) */
+    executeTool(name: string, args?: Record<string, unknown>): Promise<unknown>;
+}
+/**
+ * Factory to create and manage embeddable MCP runtime instances.
+ */
+export declare function createMcpRuntime(options: McpRuntimeOptions): Promise<McpRuntimeHandle>;
+/**
+ * Options for directly executing a single request without MCP.
+ */
+export interface RunRequestOptions {
+    /** Workspace root folder path */
+    workspaceFolder: string;
+    /** Collection ID containing the request */
+    collectionId: string;
+    /** Request ID to execute */
+    requestId: string;
+    /** Environment name (defaults to currently selected) */
+    environment?: string;
+    /** Extra variables to inject into execution */
+    variables?: Record<string, unknown>;
+    /** Override or add request headers */
+    headers?: Record<string, string>;
+    /** Override query parameters */
+    query?: Record<string, string>;
+    /** Replace request body (JSON string) */
+    body?: string;
+    /** Extra response fields to include: headers, cookies, tests, consoleOutput, report */
+    include?: string[];
+}
+/**
+ * Options for directly executing all requests in a collection without MCP.
+ */
+export interface RunCollectionOptions {
+    /** Workspace root folder path */
+    workspaceFolder: string;
+    /** Collection ID to execute */
+    collectionId: string;
+    /** Environment name (defaults to currently selected) */
+    environment?: string;
+    /** Extra variables injected into every request */
+    variables?: Record<string, unknown>;
+    /** Number of iterations (default: 1) */
+    iterations?: number;
+    /** Stop on first failure (default: false) */
+    stopOnError?: boolean;
+    /** Delay between requests in milliseconds (default: 0) */
+    delay?: number;
+    /** Extra response fields to include: perRequest, failedOnly, consoleOutput */
+    include?: string[];
+}
+/**
+ * Options for directly executing a test suite without MCP.
+ */
+export interface RunSuiteOptions {
+    /** Workspace root folder path */
+    workspaceFolder: string;
+    /** Suite ID to execute */
+    suiteId: string;
+    /** Environment name (defaults to currently selected) */
+    environment?: string;
+    /** Extra variables injected into every request */
+    variables?: Record<string, unknown>;
+    /** Number of iterations (overrides suite default) */
+    iterations?: number;
+    /** Stop on first failure (overrides suite default) */
+    stopOnError?: boolean;
+    /** Delay between requests in ms (overrides suite default) */
+    delay?: number;
+    /** Run only requests whose names match one of these strings (case-insensitive) */
+    requestFilter?: string[];
+    /** Extra response fields to include: perRequest, failedOnly, consoleOutput */
+    include?: string[];
+}
+/**
+ * Execute a single request directly without MCP server.
+ * Returns typed result object; never calls process.exit.
+ */
+export declare function runRequest(options: RunRequestOptions): Promise<unknown>;
+/**
+ * Execute a collection directly without MCP server.
+ * Returns typed result object; never calls process.exit.
+ */
+export declare function runCollection(options: RunCollectionOptions): Promise<unknown>;
+/**
+ * Execute a test suite directly without MCP server.
+ * Returns typed result object; never calls process.exit.
+ */
+export declare function runSuite(options: RunSuiteOptions): Promise<unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@http-forge/core",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Headless HTTP testing engine with Postman collection support, dynamic variables, and script-based automation.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -44,7 +44,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/hsl1230/http-forge",
+    "url": "git+https://github.com/hsl1230/http-forge.git",
     "directory": "packages/core"
   },
   "engines": {
@@ -56,7 +56,7 @@
     "lodash": "^4.17.21",
     "moment": "^2.30.1",
     "tv4": "^1.3.0",
-    "uuid": "^9.0.1",
+    "uuid": "^14.0.0",
     "yaml": "^2.7.0"
   },
   "devDependencies": {
@@ -64,10 +64,10 @@
     "@types/node": "^20.10.0",
     "@types/tv4": "^1.2.33",
     "@types/uuid": "^9.0.7",
-    "esbuild": "^0.20.0",
+    "esbuild": "^0.28.1",
     "rimraf": "^5.0.5",
     "tsup": "^8.0.1",
     "typescript": "^5.3.0",
-    "vitest": "^1.1.0"
+    "vitest": "^4.1.9"
   }
 }