@http-forge/core 0.2.8 → 0.2.10

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

@@ -43,9 +43,24 @@ export declare class EnvironmentConfigService implements IEnvironmentConfigServi
     getEnvironmentNames(): string[];
     getSelectedEnvironment(): string;
     setSelectedEnvironment(envName: string): Promise<void>;
+    private getEnvOverridesStateKey;
+    /**
+     * Load persisted environment overrides from workspace state into the in-memory map.
+     * Called once at construction time.
+     */
+    private loadPersistedEnvironmentOverrides;
+    /**
+     * Persist current environment overrides to workspace state (fire-and-forget).
+     */
+    private persistEnvironmentOverrides;
     setEnvironmentVariable(key: string, value: unknown): void;
     deleteEnvironmentVariable(key: string): void;
     clearEnvironmentVariables(): void;
+    /**
+     * Reset all runtime environment overrides for the current environment.
+     * Equivalent to Postman's "Reset All" — reverts Current Values to Initial Values.
+     */
+    resetEnvironmentOverrides(envName?: string): Promise<void>;
     getEnvironmentVariableLocal(key: string): string | undefined;
     getEnvironmentVariableLocals(): Record<string, string>;
     setGlobalVariable(key: string, value: unknown): void;
@@ -55,12 +70,17 @@ export declare class EnvironmentConfigService implements IEnvironmentConfigServi
     getGlobalVariableLocals(): Record<string, string>;
     deleteGlobalVariable(key: string): void;
     clearGlobalVariables(): void;
-    private getSessionStateKey;
+    /** @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;
     resolveVariables(input: string, envName?: string): string;

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

@@ -9,12 +9,12 @@
  *
  * Used by both Request Tester (manual) and Collection Runner (batch).
  */
-import { IOAuth2TokenManager } from '../auth/interfaces';
 import { IEnvironmentConfigService, ResolvedEnvironment } from '../../types/environment-config';
-import { IHttpRequestService } from '../http/interfaces';
-import { IRequestPreprocessor } from '../http/request-preprocessor';
 import { IApplicationInfo } from '../../types/platform';
 import { ExecutionRequest, PreparedRequest } from '../../types/types';
+import { IOAuth2TokenManager } from '../auth/interfaces';
+import { IHttpRequestService } from '../http/interfaces';
+import { IRequestPreprocessor } from '../http/request-preprocessor';
 import { IRequestPreparer } from './request-preparer-interfaces';
 /**
  * RequestPreparer implementation

package/dist/infrastructure/script/request-script-session.d.ts

@@ -34,10 +34,8 @@ export declare class RequestScriptSession implements IRequestScriptSession {
     private _variables;
     private _collectionVariables;
     private _globals;
-    private _sessionVariables;
     private _environmentVariables;
     private _liveEnvironmentScope;
-    private _liveSessionScope;
     private _liveGlobalsScope;
     private _liveCollectionScope;
     private _nextRequest;

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

@@ -49,10 +49,6 @@ export declare class ScriptExecutor implements IScriptExecutor {
      * Create environment variable scope with change callbacks
      */
     private createEnvironmentScope;
-    /**
-     * Create session variable scope with change callbacks
-     */
-    private createSessionScope;
     /**
      * Create sendRequest function using httpService
      */

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

@@ -5,7 +5,7 @@
  * The legacy ScriptExecutor uses `createRequestSession()` pattern;
  * this adapter translates to the simpler `executePreRequest` / `executePostResponse` port API.
  */
-import { IScriptExecutor as IScriptExecutorPort, IScriptSession, IScriptResult } from '../../ports/executors/script-executor.interface';
+import { IScriptExecutor as IScriptExecutorPort, IScriptResult, IScriptSession } from '../../ports/executors/script-executor.interface';
 import { HttpResponse } from '../../types/types';
 import { ScriptExecutor } from './script-executor';
 /**

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

@@ -41,3 +41,77 @@ export declare function redactFullResponse(response: FullResponse): FullResponse
  * Redact sensitive data from a FullResultDetails (suite test result).
  */
 export declare function redactFullResultDetails(result: FullResultDetails): FullResultDetails;
+/** A single warning about a hardcoded sensitive value. */
+export interface SensitiveDataWarning {
+    /** Where the issue was found (e.g. "header", "auth", "body", "query", "url") */
+    location: string;
+    /** The field name that matched (e.g. "Authorization", "password") */
+    field: string;
+    /** Human-readable guidance */
+    message: string;
+}
+/**
+ * Check a request for hardcoded sensitive data that should use environment
+ * variables instead. Returns an array of warnings. An empty array means the
+ * request is safe to save.
+ *
+ * Only values that are NOT `{{variable}}` template references are flagged.
+ */
+export declare function detectSensitiveData(request: {
+    url?: string;
+    headers?: Record<string, string> | Array<{
+        key: string;
+        value: string;
+        enabled?: boolean;
+    }>;
+    query?: Record<string, string> | Array<{
+        key: string;
+        value: string;
+        enabled?: boolean;
+    }>;
+    body?: any;
+    auth?: any;
+}): SensitiveDataWarning[];
+/**
+ * A single sensitive value that can be extracted to a .local.json variable.
+ */
+export interface SensitiveExtraction {
+    /** Where the value was found */
+    location: 'header' | 'query' | 'body' | 'auth' | 'url';
+    /** The field name / key (e.g. "Authorization", "password") */
+    field: string;
+    /** Dot-path for nested body fields (e.g. "credentials.secret") */
+    path?: string;
+    /** The hardcoded value to extract */
+    value: string;
+    /** Suggested variable name for the .local.json file */
+    variableName: string;
+}
+/**
+ * Scan a request and build an extraction plan: a list of all hardcoded sensitive
+ * values with their locations and suggested variable names.
+ *
+ * The caller can use this plan to:
+ * 1. Write the values to a .local.json environment file
+ * 2. Replace each value with {{variableName}} in the request before saving
+ */
+export declare function buildExtractionPlan(request: {
+    url?: string;
+    headers?: Record<string, string> | Array<{
+        key: string;
+        value: string;
+        enabled?: boolean;
+    }>;
+    query?: Record<string, string> | Array<{
+        key: string;
+        value: string;
+        enabled?: boolean;
+    }>;
+    body?: any;
+    auth?: any;
+}): SensitiveExtraction[];
+/**
+ * Apply an extraction plan to a request: replace hardcoded values with {{variableName}}.
+ * Returns a deep copy of the request with all sensitive values replaced.
+ */
+export declare function applyExtractionPlan(request: any, plan: SensitiveExtraction[]): any;

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

@@ -5,9 +5,12 @@
  */
 /**
  * Request reference within a Test Suite
- * References a request from a Collection (not a copy)
+ * References a request from a Collection with an optional embedded snapshot.
+ * When a slug is present, request data lives in the suite's folder structure.
  */
 export interface SuiteRequest {
+    /** Folder slug (directory name) within the suite — required for folder-based suites */
+    slug?: string;
     /** Collection ID where the request lives */
     collectionId: string;
     /** Collection name for display purposes */

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

@@ -2,9 +2,10 @@
  * Test Suite Store
  *
  * Manages suite requests that can come from different collections.
- * Resolves requests fresh from ICollectionService to ensure latest data.
+ * Supports folder-based suite storage where each request has its own directory.
+ * Falls back to resolving from collection service for legacy suites.
  *
- * Single Responsibility: Maintain suite state and resolve requests from collections
+ * Single Responsibility: Maintain suite state and resolve requests
  * Dependency Inversion: Depends on ICollectionService abstraction
  */
 import { CollectionRequest, ICollectionService, RequestScripts } from '../../types/collection';
@@ -30,6 +31,10 @@ export interface ITestSuiteStore {
      * Set the test suite
      */
     setSuite(suite: TestSuite): void;
+    /**
+     * Set the suite directory path (for folder-based suites)
+     */
+    setSuiteDir(dir: string | undefined): void;
     /**
      * Get the current suite
      */
@@ -38,6 +43,10 @@ export interface ITestSuiteStore {
      * Get a request by ID with full context (collection scripts + folder scripts)
      */
     getRequestWithContext(collectionId: string, requestId: string): SuiteRequestEntry | undefined;
+    /**
+     * Get a request by slug with full context
+     */
+    getRequestBySlug(slug: string): SuiteRequestEntry | undefined;
     /**
      * Get all suite requests with their resolved data
      */
@@ -55,6 +64,8 @@ export interface ITestSuiteStore {
         collectionName: string;
         folderPath: string;
         enabled: boolean;
+        hasEmbeddedRequest: boolean;
+        slug?: string;
     }>;
     /**
      * Get suite requests by selection state
@@ -62,9 +73,9 @@ export interface ITestSuiteStore {
      */
     getSelectedRequests(selectedIds: string[]): SuiteRequestEntry[];
     /**
-     * Add a request to the suite
+     * Add a request to the suite (creates folder if suiteDir is set)
      */
-    addRequest(request: SuiteRequest): void;
+    addRequest(request: SuiteRequest, fullRequest?: CollectionRequest): void;
     /**
      * Remove a request from the suite
      */
@@ -73,6 +84,14 @@ export interface ITestSuiteStore {
      * Reorder requests
      */
     reorderRequests(requestIds: string[]): void;
+    /**
+     * Update a suite request's data in its folder
+     */
+    updateSuiteRequest(slug: string, updatedRequest: CollectionRequest): void;
+    /**
+     * Re-sync a suite request from its source collection
+     */
+    resyncFromCollection(slug: string): CollectionRequest | undefined;
 }
 /**
  * Implementation of TestSuiteStore
@@ -80,17 +99,37 @@ export interface ITestSuiteStore {
 export declare class TestSuiteStore implements ITestSuiteStore {
     private readonly collectionService;
     private suite;
+    private suiteDir;
     constructor(collectionService: ICollectionService);
     /**
      * Set the suite
      */
     setSuite(suite: TestSuite): void;
+    /**
+     * Set the suite directory (for folder-based storage)
+     */
+    setSuiteDir(dir: string | undefined): void;
     /**
      * Get the current suite
      */
     getSuite(): TestSuite | undefined;
     /**
-     * Resolve a suite request to its full request data
+     * Load a suite request from its folder.
+     * Reads request.json + scripts/pre-request.js + scripts/post-response.js
+     */
+    private loadSuiteRequest;
+    /**
+     * Save a suite request to its folder.
+     * Writes request.json + scripts/pre-request.js + scripts/post-response.js
+     */
+    private saveSuiteRequest;
+    /**
+     * Check if a suite request has embedded data in its folder
+     */
+    private hasEmbeddedRequest;
+    /**
+     * Resolve a suite request to its full request data.
+     * Priority: suite folder → collection (fallback for legacy suites)
      */
     private resolveRequest;
     /**
@@ -115,6 +154,7 @@ export declare class TestSuiteStore implements ITestSuiteStore {
      * Always resolves fresh from collection service to ensure latest data
      */
     getRequestWithContext(collectionId: string, requestId: string): SuiteRequestEntry | undefined;
+    getRequestBySlug(slug: string): SuiteRequestEntry | undefined;
     /**
      * Get all suite requests with resolved data
      * Always resolves fresh from collection service to ensure latest data
@@ -134,6 +174,8 @@ export declare class TestSuiteStore implements ITestSuiteStore {
         collectionName: string;
         folderPath: string;
         enabled: boolean;
+        hasEmbeddedRequest: boolean;
+        slug?: string;
     }>;
     /**
      * Get selected requests in order
@@ -141,9 +183,14 @@ export declare class TestSuiteStore implements ITestSuiteStore {
      */
     getSelectedRequests(selectedIds: string[]): SuiteRequestEntry[];
     /**
-     * Add a request to the suite
+     * Add a request to the suite.
+     * If fullRequest is provided and suiteDir is set, creates a folder with request.json + scripts.
      */
-    addRequest(request: SuiteRequest): void;
+    addRequest(request: SuiteRequest, fullRequest?: CollectionRequest): void;
+    /**
+     * Resolve a unique slug (handle duplicates with numeric suffix)
+     */
+    private resolveUniqueSlug;
     /**
      * Remove a request from the suite
      */
@@ -152,4 +199,14 @@ export declare class TestSuiteStore implements ITestSuiteStore {
      * Reorder requests by request IDs (format: "collectionId:requestId")
      */
     reorderRequests(orderedKeys: string[]): void;
+    /**
+     * Update the request data in the suite folder.
+     * Called when user edits a request from the suite panel.
+     */
+    updateSuiteRequest(slug: string, updatedRequest: CollectionRequest): void;
+    /**
+     * Replace the suite request with the latest version from the collection.
+     * Overwrites the request folder content.
+     */
+    resyncFromCollection(slug: string): CollectionRequest | undefined;
 }

package/package.json

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