@http-forge/core 0.4.0 → 0.4.2

package/dist/infrastructure/environment/environment-config-service.d.ts

@@ -56,9 +56,9 @@ export declare class EnvironmentConfigService implements IEnvironmentConfigServi
      * Persist current environment overrides to workspace state (fire-and-forget).
      */
     private persistEnvironmentOverrides;
-    setEnvironmentVariable(key: string, value: unknown): void;
-    deleteEnvironmentVariable(key: string): void;
-    clearEnvironmentVariables(): void;
+    setEnvironmentVariable(key: string, value: unknown, envName?: string): void;
+    deleteEnvironmentVariable(key: string, envName?: string): void;
+    clearEnvironmentVariables(envName?: string): void;
     /**
      * Reset all runtime environment overrides for the current environment.
      * Equivalent to Postman's "Reset All" — reverts Current Values to Initial Values.
@@ -73,18 +73,6 @@ export declare class EnvironmentConfigService implements IEnvironmentConfigServi
     getGlobalVariableLocals(): Record<string, string>;
     deleteGlobalVariable(key: string): void;
     clearGlobalVariables(): void;
-    /** @deprecated Use setEnvironmentVariable instead */
-    setSessionVariable(key: string, value: unknown): Promise<void>;
-    /** @deprecated Use getEnvironmentVariableLocal instead */
-    getSessionVariable(key: string): string | undefined;
-    /** @deprecated Use getEnvironmentVariableLocals instead */
-    getSessionVariables(): Record<string, string>;
-    /** @deprecated Use deleteEnvironmentVariable instead */
-    deleteSessionVariable(key: string): Promise<void>;
-    /** @deprecated Use clearEnvironmentVariables instead */
-    clearSessionVariables(): Promise<void>;
-    /** @deprecated Use getEnvironmentVariableLocal instead */
-    hasSessionVariable(key: string): boolean;
     getResolvedEnvironment(envName?: string): ResolvedEnvironment | null;
     /**
      * Retrieve a secret variable value from SecretStorage.

package/dist/infrastructure/execution/request-executor.d.ts

@@ -4,11 +4,11 @@
  * Single Responsibility: Orchestrate the complete request execution flow
  * Facade Pattern: Provides simplified interface to complex subsystem
  */
+import { IHttpClient } from '../../types/platform';
+import { HttpRequest, HttpResponse, RequestOverrides, ScriptResult, UnifiedCollection, UnifiedRequest } from '../../types/types';
 import { IForgeEnv } from '../environment/forge-env';
 import { IRequestPreprocessor } from '../http/request-preprocessor';
 import { IScriptExecutor } from '../script/interfaces';
-import { IHttpClient } from '../../types/platform';
-import { HttpRequest, HttpResponse, RequestOverrides, ScriptResult, UnifiedCollection, UnifiedRequest } from '../../types/types';
 /**
  * Options for request execution
  */
@@ -25,8 +25,6 @@ export interface ExecuteOptions {
     additionalVariables?: Record<string, string>;
     /** Timeout override */
     timeout?: number;
-    /** Callback when scripts modify session variables */
-    onSessionChange?: (action: 'set' | 'unset' | 'clear', key?: string, value?: string) => void;
     /** Callback when scripts modify environment variables */
     onEnvironmentChange?: (action: 'set' | 'unset' | 'clear', key?: string, value?: string) => void;
 }

package/dist/infrastructure/script/interfaces.d.ts

@@ -7,8 +7,8 @@
  * Dependency Inversion: Define abstractions for request execution components
  * Interface Segregation: Each interface has a focused purpose
  */
-import { Cookie } from '../cookie/interfaces';
 import { PreparedRequest, RequestAuth, RequestBody, RequestScripts, RequestSettings, ScriptInfo, TestAssertion } from '../../types/types';
+import { Cookie } from '../cookie/interfaces';
 export type { Cookie, ScriptInfo };
 /**
  * Cookie Jar Interface
@@ -69,7 +69,6 @@ export interface CommonScriptContext {
     iteration?: number;
     iterationCount?: number;
     iterationData?: Record<string, any>;
-    onSessionChange?: (action: 'set' | 'unset' | 'clear', key?: string, value?: string) => void;
     onEnvironmentChange?: (action: 'set' | 'unset' | 'clear', key?: string, value?: string) => void;
 }
 /**

package/dist/infrastructure/script/script-executor.d.ts

@@ -9,6 +9,7 @@
  * It configures the VM sandbox and delegates session management to RequestScriptSession.
  */
 import { IHttpRequestService } from '../http/interfaces';
+import { SecretResolverRegistry } from '../secrets/secret-resolver-registry';
 import { IRequestScriptSession, IScriptExecutor, PreRequestScriptContext } from './interfaces';
 /**
  * Script Executor Implementation
@@ -20,8 +21,9 @@ import { IRequestScriptSession, IScriptExecutor, PreRequestScriptContext } from
  */
 export declare class ScriptExecutor implements IScriptExecutor {
     private readonly httpService?;
+    private readonly secretRegistry?;
     private readonly moduleLoader;
-    constructor(httpService?: IHttpRequestService | undefined, modulePaths?: string[]);
+    constructor(httpService?: IHttpRequestService | undefined, modulePaths?: string[], secretRegistry?: SecretResolverRegistry | undefined);
     /**
      * Create a request execution session
      * Factory method implementing IScriptExecutor
@@ -60,6 +62,13 @@ export declare class ScriptExecutor implements IScriptExecutor {
      * Create environment variable scope with change callbacks
      */
     private createEnvironmentScope;
+    /**
+     * Create the Postman-compatible pm.vault namespace.
+     * Reads are backed by HTTP Forge's secret provider system using the same
+     * {{secret:provider/path}} resolution. Writes are not supported (read-only),
+     * and resolved values are never persisted to console/report output here.
+     */
+    private createVault;
     /**
      * Create sendRequest function using httpService
      */

package/dist/infrastructure/script/script-factories.d.ts

@@ -5,6 +5,15 @@
  * Open/Closed: New factory methods can be added without modifying existing ones
  */
 import { ResponseContext } from './interfaces';
+/**
+ * Minimal, dependency-free JSON Schema validator.
+ *
+ * Supports the common subset used in API tests (draft-04 style):
+ * `type`, `properties`, `required`, `items`, `enum`, `additionalProperties`
+ * (boolean), `minimum`/`maximum`, `minLength`/`maxLength`, and `pattern`.
+ * Returns a list of human-readable error strings (empty when valid).
+ */
+export declare function validateJsonSchema(data: any, schema: any, path?: string): string[];
 /**
  * Response object interface for script context
  */
@@ -36,6 +45,7 @@ export interface ResponseAssertions {
         header(headerName: string, expectedValue?: string): void;
         body(expectedBody?: string): void;
         jsonBody(expectedJson?: any): void;
+        jsonSchema(schema: any): void;
     };
     be: {
         readonly ok: any;
@@ -62,12 +72,27 @@ export interface ExpectChain {
     be: ExpectChain;
     have: ExpectChain;
     deep: ExpectChain;
+    and: ExpectChain;
+    that: ExpectChain;
+    which: ExpectChain;
+    is: ExpectChain;
+    been: ExpectChain;
+    has: ExpectChain;
+    with: ExpectChain;
+    at: ExpectChain;
+    of: ExpectChain;
+    same: ExpectChain;
+    but: ExpectChain;
+    does: ExpectChain;
+    still: ExpectChain;
+    also: ExpectChain;
     equal(expected: any): ExpectChain;
     eql(expected: any): ExpectChain;
     property(name: string, value?: any): ExpectChain;
     ok: ExpectChain;
     exist: ExpectChain;
     include(value: any): ExpectChain;
+    contain(value: any): ExpectChain;
     oneOf(values: any[]): ExpectChain;
     match(pattern: RegExp): ExpectChain;
     above(num: number): ExpectChain;

package/dist/infrastructure/test-suite/html-report-generator.d.ts

@@ -5,6 +5,13 @@
  * generates a self-contained single-file HTML report (no external dependencies).
  *
  * Output: {basePath}/{suiteId}/{runId}/report.html
+ *
+ * Each request entry expands to show:
+ *   - Full request URL, method, headers, body
+ *   - Response status, headers, body (pretty-printed)
+ *   - All test assertions (pass/fail + messages)
+ *   - Console output (if any)
+ *   - Error message (if any)
  */
 export declare class HtmlReportGenerator {
     private readonly basePath;
@@ -15,6 +22,22 @@ export declare class HtmlReportGenerator {
      */
     generate(suiteId: string, runId: string): Promise<string>;
     private loadAllSummaries;
-    private loadFailedDetails;
+    /** Load every result file for every request (pass + fail). */
+    private loadAllDetails;
+    /**
+     * Group summaries by iteration, then by (collection + folder path),
+     * preserving execution order within each tier.
+     */
+    private groupByIterCollectionFolder;
+    /**
+     * Build a combined group header label like:
+     *   "01 - MyCollection: Auth/Login"
+     * Collection or folder parts are omitted when empty; falls back to "(root)".
+     */
+    private groupLabel;
+    /** Render the detail accordions grouped by iteration → (collection + folder). */
+    private renderGroupedDetails;
+    /** Render the timeline table rows grouped by iteration → (collection + folder). */
+    private renderGroupedTimeline;
     private buildHtml;
 }

package/dist/infrastructure/test-suite/interfaces.d.ts

@@ -147,6 +147,7 @@ export interface ITestSuiteService {
     deleteSuite(id: string): Promise<boolean>;
     duplicateSuite(sourceId: string, newName: string): Promise<TestSuite>;
     createTempSuiteFromCollection(collectionId: string): Promise<TestSuite | undefined>;
+    createTempSuiteFromFolder(collectionId: string, folderPath: string, recursive?: boolean): Promise<TestSuite | undefined>;
     saveTempSuite(suite: TestSuite, name: string): Promise<TestSuite>;
 }
 /**

package/dist/infrastructure/test-suite/result-storage-service.d.ts

@@ -45,7 +45,7 @@ export declare class ResultStorageService implements IResultStorageService {
      * Finalize run
      * @returns path to the generated HTML report, or null if generation failed
      */
-    finalizeRun(status?: 'completed' | 'aborted' | 'error'): Promise<string | null>;
+    finalizeRun(status?: 'completed' | 'aborted' | 'error', generateHtmlReport?: boolean): Promise<string | null>;
     getCurrentStats(): {
         stats: RunStats;
         requestStats: Record<string, RequestStats>;

package/dist/infrastructure/test-suite/result-storage.d.ts

@@ -39,6 +39,10 @@ export interface ResultSummary {
     r: string;
     /** Error message if failed (e) - null if passed */
     e: string | null;
+    /** Folder path (fp) - slash-separated; omitted/empty for root-level requests */
+    fp?: string;
+    /** Collection name (cn) - omitted/empty when unknown */
+    cn?: string;
 }
 /**
  * Build result filename from summary components
@@ -169,6 +173,10 @@ export interface FullResultDetails {
     method: string;
     /** Full URL */
     url: string;
+    /** Folder path within the collection (slash-separated; empty for root) */
+    folderPath?: string;
+    /** Name of the collection this request belongs to */
+    collectionName?: string;
     /** HTTP status code */
     status: number;
     /** HTTP status text */
@@ -181,13 +189,27 @@ export interface FullResultDetails {
     timestamp: number;
     /** Request details */
     request: {
+        method: string;
+        url: string;
         headers: Record<string, string>;
-        body: any;
+        query: Record<string, string>;
+        params: Record<string, string>;
+        body: {
+            type: string;
+            format?: string;
+            content: any;
+        };
     };
     /** Response details */
     response: {
         headers: Record<string, string | string[]>;
         body: any;
+        time?: number;
+        size?: number;
+        cookies?: Array<{
+            name?: string;
+            value?: string;
+        }>;
     };
     /** Test assertions */
     assertions: Array<{
@@ -197,6 +219,23 @@ export interface FullResultDetails {
     }>;
     /** Error message */
     error: string | null;
+    /** Console output produced while running the request */
+    consoleOutput?: string[];
+    /** Variables modified by pre/post scripts */
+    modifiedVariables?: Record<string, string>;
+    /** Environment variables modified by scripts */
+    modifiedEnvironmentVariables?: Record<string, string>;
+    /** Collection variables modified by scripts */
+    modifiedCollectionVariables?: Record<string, string>;
+    /** Session variables modified by scripts */
+    modifiedSessionVariables?: Record<string, string>;
+    /** pm.execution.setNextRequest() value */
+    nextRequest?: string | null;
+    /** pm.visualizer.set() payload */
+    visualizerData?: {
+        template: string;
+        data?: any;
+    };
 }
 /**
  * Index page containing summaries
@@ -248,9 +287,12 @@ export interface IResultStorageService {
     saveResult(iteration: number, result: ExecutionResult): Promise<ResultSummary>;
     /**
      * Finalize run
-     * @returns path to the generated HTML report, or null if generation failed
+     * @param status final run status
+     * @param generateHtmlReport when false, the run is persisted (manifest + results)
+     *        but the HTML report is not generated; returns null in that case
+     * @returns path to the generated HTML report, or null if not generated / generation failed
      */
-    finalizeRun(status: 'completed' | 'aborted' | 'error'): Promise<string | null>;
+    finalizeRun(status: 'completed' | 'aborted' | 'error', generateHtmlReport?: boolean): Promise<string | null>;
     /**
      * Get current run stats
      */

package/dist/infrastructure/test-suite/test-suite-service.d.ts

@@ -79,6 +79,16 @@ export declare class TestSuiteService implements ITestSuiteService {
      * Create a temporary suite from a collection
      */
     createTempSuiteFromCollection(collectionId: string): Promise<TestSuite | undefined>;
+    /**
+     * Create a temporary suite from a single folder within a collection.
+     *
+     * @param collectionId - the owning collection
+     * @param folderPath - slash-separated folder names (e.g. "Auth/Login")
+     * @param recursive - include requests in nested subfolders (default: true)
+     */
+    createTempSuiteFromFolder(collectionId: string, folderPath: string, recursive?: boolean): Promise<TestSuite | undefined>;
+    /** Convert a folder path into an id-safe slug. */
+    private slugifyFolderPath;
     /**
      * Save a temporary suite as a permanent one
      */

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

@@ -20,6 +20,15 @@ export declare function runRequest(options: RunRequestOptions): Promise<unknown>
  * Returns typed result; never calls process.exit.
  */
 export declare function runCollection(options: RunCollectionOptions): Promise<unknown>;
+/**
+ * Execute the requests under a specific folder of a collection without MCP
+ * server overhead. Thin wrapper over {@link runCollection} that scopes the run
+ * to `options.folderPath` (recursively by default). Returns the same result
+ * shape as a collection run.
+ */
+export declare function runFolder(options: RunCollectionOptions & {
+    folderPath: string;
+}): Promise<unknown>;
 /**
  * Execute a test suite without MCP server overhead.
  * Returns typed result; never calls process.exit.

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

@@ -84,6 +84,16 @@ export interface RunCollectionOptions {
     delay?: number;
     /** Extra response fields to include: perRequest, failedOnly, consoleOutput */
     include?: string[];
+    /**
+     * Restrict execution to requests under this folder path (slash-separated
+     * folder names, e.g. "Auth/Login"). When omitted, the whole collection runs.
+     */
+    folderPath?: string;
+    /**
+     * When a `folderPath` is provided, include requests in nested subfolders
+     * (default: true). When false, only requests directly in that folder run.
+     */
+    recursive?: boolean;
 }
 /**
  * Options for directly executing a test suite without MCP.
@@ -118,6 +128,14 @@ export declare function runRequest(options: RunRequestOptions): Promise<unknown>
  * Returns typed result object; never calls process.exit.
  */
 export declare function runCollection(options: RunCollectionOptions): Promise<unknown>;
+/**
+ * Execute the requests under a specific folder of a collection without MCP
+ * server. Thin wrapper over {@link runCollection} scoped to `folderPath`
+ * (recursively by default). Returns the same result shape as a collection run.
+ */
+export declare function runFolder(options: RunCollectionOptions & {
+    folderPath: string;
+}): Promise<unknown>;
 /**
  * Execute a test suite directly without MCP server.
  * Returns typed result object; never calls process.exit.

package/dist/types/environment-config.d.ts

@@ -100,18 +100,14 @@ export interface IVariableResolver {
  * Variable management operations (for scripts)
  */
 export interface IVariableManager {
-    setEnvironmentVariable(key: string, value: unknown): void;
-    deleteEnvironmentVariable(key: string): void;
-    clearEnvironmentVariables(): void;
+    setEnvironmentVariable(key: string, value: unknown, envName?: string): void;
+    deleteEnvironmentVariable(key: string, envName?: string): void;
+    clearEnvironmentVariables(envName?: string): void;
     getEnvironmentVariableLocals(): Record<string, string>;
     setGlobalVariable(key: string, value: unknown): void;
     getGlobalVariable(key: string): string | undefined;
     deleteGlobalVariable(key: string): void;
     clearGlobalVariables(): void;
-    setSessionVariable(key: string, value: unknown): void;
-    deleteSessionVariable(key: string): Promise<void>;
-    clearSessionVariables(): Promise<void>;
-    getSessionVariables(): Record<string, string>;
     getGlobalVariables(): Record<string, string>;
 }
 /**

package/dist/types/types.d.ts

@@ -292,6 +292,8 @@ export interface TestAssertion {
     name: string;
     passed: boolean;
     message?: string;
+    /** True when the test was explicitly skipped via pm.test.skip(...) */
+    skipped?: boolean;
 }
 /**
  * Request overrides that can be applied at runtime
@@ -619,6 +621,10 @@ export interface ExecutionResult {
     modifiedCollectionVariables?: Record<string, string>;
     modifiedSessionVariables?: Record<string, string>;
     error?: string;
+    /** Folder path of the request within its collection (slash-separated; empty for root) */
+    folderPath?: string;
+    /** Name of the collection this request belongs to (for multi-collection suite reports) */
+    collectionName?: string;
     /** Postman-compatible: pm.execution.setNextRequest() value. null = stop runner. */
     nextRequest?: string | null;
     /** Postman-compatible: pm.visualizer.set(template, data) output */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@http-forge/core",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Headless HTTP testing engine with Postman collection support, dynamic variables, and script-based automation.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",