@http-forge/core 0.4.5 → 0.4.6

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

@@ -113,7 +113,7 @@ export declare class EnvironmentConfigService implements IEnvironmentConfigServi
     private getEnvLocalConfigPath;
     private loadFolderConfigs;
     /**
-     * Create a VariableResolver pre-loaded with environment + session variables.
+     * Create a VariableResolver pre-loaded with environment variables.
      */
     private createResolver;
     private saveFolderSharedConfig;

package/dist/infrastructure/environment/environment-resolver.d.ts

@@ -77,6 +77,15 @@ export declare class EnvironmentResolver implements IEnvironmentStore {
      * Set a global variable
      */
     setGlobal(key: string, value: string): void;
+    /**
+     * Remove a session global variable. File-defined globals (globalVariables)
+     * are defaults and cannot be deleted here — only session overrides are removed.
+     */
+    unsetGlobal(key: string): void;
+    /**
+     * Clear all session global variables. File-defined globals are left intact.
+     */
+    clearGlobals(): void;
     /**
      * Resolve environment for execution
      */

package/dist/infrastructure/environment/forge-env.d.ts

@@ -30,8 +30,8 @@
  * env.get('token');  // 'abc'
  * ```
  */
-import { EnvironmentResolver } from './environment-resolver';
 import type { IEnvironmentStore, IVariableInterpolator } from '../../types/environment-config';
+import { EnvironmentResolver } from './environment-resolver';
 /**
  * ForgeEnv interface - the public API for environment management
  */
@@ -69,6 +69,22 @@ export interface IForgeEnv {
      * Get list of available environment names
      */
     getEnvironments(): string[];
+    /**
+     * Get all global variables (environment-agnostic variable layer)
+     */
+    getGlobals(): Record<string, string>;
+    /**
+     * Set a global variable value
+     */
+    setGlobal(key: string, value: string): void;
+    /**
+     * Remove a global variable
+     */
+    unsetGlobal(key: string): void;
+    /**
+     * Clear all (session) global variables
+     */
+    clearGlobals(): void;
     /**
      * Resolve {{variable}} placeholders in a string
      */
@@ -127,6 +143,23 @@ export declare class ForgeEnv implements IForgeEnv {
      * Get list of available environment names
      */
     getEnvironments(): string[];
+    /**
+     * Get all global variables. Globals are the lowest-priority, environment-agnostic
+     * variable layer — treated like environment variables with no environment scope.
+     */
+    getGlobals(): Record<string, string>;
+    /**
+     * Set a global variable value.
+     */
+    setGlobal(key: string, value: string): void;
+    /**
+     * Remove a (session) global variable.
+     */
+    unsetGlobal(key: string): void;
+    /**
+     * Clear all (session) global variables.
+     */
+    clearGlobals(): void;
     /**
      * Resolve {{variable}} placeholders
      */

package/dist/infrastructure/environment/variable-interpolator.d.ts

@@ -28,13 +28,12 @@ export interface VariableResolverConfig {
     globals: Record<string, string>;
     collectionVariables: Record<string, string>;
     environmentVariables: Record<string, string>;
-    sessionVariables: Record<string, string>;
     variables: Record<string, string>;
 }
 /**
  * Variable Resolver - Resolves {{varName}} patterns in strings and objects
  * Uses a 5-step pipeline: $dynamic → filter chains → simple lookup → JS expressions → passthrough
- * Variable precedence: globals > collection > environment > session > request > extra
+ * Variable precedence: globals > collection > environment > request > extra
  */
 export declare class VariableResolver {
     private readonly allVariables;

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

@@ -61,7 +61,6 @@ export interface CommonScriptContext {
     variables: Record<string, string>;
     collectionVariables?: Record<string, string>;
     globals?: Record<string, string>;
-    sessionVariables?: Record<string, string>;
     environmentVariables?: Record<string, string>;
     environmentName?: string;
     sendRequest?: (options: any) => Promise<any>;
@@ -70,6 +69,7 @@ export interface CommonScriptContext {
     iterationCount?: number;
     iterationData?: Record<string, any>;
     onEnvironmentChange?: (action: 'set' | 'unset' | 'clear', key?: string, value?: string) => void;
+    onGlobalsChange?: (action: 'set' | 'unset' | 'clear', key?: string, value?: string) => void;
 }
 /**
  * Script execution context for pre-request scripts
@@ -95,7 +95,6 @@ export interface PreRequestScriptResult {
     modifiedVariables?: Record<string, string>;
     modifiedCollectionVariables?: Record<string, string>;
     modifiedGlobals?: Record<string, string>;
-    modifiedSessionVariables?: Record<string, string>;
     modifiedEnvironmentVariables?: Record<string, string>;
     consoleOutput?: string[];
     /** Postman-compatible: pm.execution.setNextRequest() value. null = stop runner. */
@@ -110,7 +109,8 @@ export interface PostResponseScriptResult {
     testResults: TestAssertion[];
     consoleOutput?: string[];
     modifiedEnvironmentVariables?: Record<string, string>;
-    modifiedSessionVariables?: Record<string, string>;
+    modifiedGlobals?: Record<string, string>;
+    modifiedCollectionVariables?: Record<string, string>;
     /** Postman-compatible: pm.execution.setNextRequest() value. null = stop runner. */
     nextRequest?: string | null;
     /** Postman-compatible: pm.visualizer.set(template, data) output */

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

@@ -55,6 +55,13 @@ export declare class ScriptExecutor implements IScriptExecutor {
      * Create a basic variable scope with get/set/has/unset/clear/toObject
      */
     private createVariableScope;
+    /**
+     * Create the globals scope with change callbacks.
+     * Globals are a special, environment-agnostic variable layer, so they are
+     * persisted live through the same push-callback mechanism as environment
+     * variables (see createEnvironmentScope) rather than a post-hoc diff.
+     */
+    private createGlobalsScope;
     /**
      * Create merged variable scope (Postman-style cascading lookup)
      */

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

@@ -227,8 +227,6 @@ export interface FullResultDetails {
     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 */

package/dist/types/types.d.ts

@@ -218,7 +218,6 @@ export interface ExecutionVariables {
     variables: Record<string, string>;
     collectionVariables?: Record<string, string>;
     globals?: Record<string, string>;
-    sessionVariables?: Record<string, string>;
     environmentVariables?: Record<string, string>;
 }
 /**
@@ -619,7 +618,6 @@ export interface ExecutionResult {
     modifiedVariables?: Record<string, string>;
     modifiedEnvironmentVariables?: Record<string, string>;
     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;

package/package.json

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