@http-forge/core 0.4.4 → 0.4.6

package/README.md

@@ -252,6 +252,21 @@ if (pm.response.headers.has('Set-Cookie')) {
 }
 ```
 
+#### Script Scope
+
+Control how script levels (collection → folder → request) and the pre-request/post-response phases share a JavaScript scope via `scripts.scope` in `http-forge.config.json` (or the `scriptScope` SDK option):
+
+| Mode | Behavior |
+|------|----------|
+| `'shared'` *(default)* | All levels and both phases run in one scope. `var`/`function` and global assignments leak across them; lowest overhead. Top-level `let`/`const` are scoped to a single phase. |
+| `'isolated'` | Each level runs in its own scope, matching Postman. Declarations cannot collide or leak; pass state through `pm.variables` / `pm.environment` / `pm.globals`. |
+
+```typescript
+const forge = ForgeContainer.create({ scriptScope: 'isolated' });
+```
+
+Use `'isolated'` when importing Postman collections whose scripts re-declare the same identifiers at multiple levels, which would otherwise throw `Identifier already declared` in shared mode.
+
 ### Environment Management
 
 ```typescript

package/dist/container.d.ts

@@ -26,13 +26,13 @@ import { ParserRegistry } from './infrastructure/collection/parser-registry';
 import { ICookieService } from './infrastructure/cookie/interfaces';
 import { EnvironmentResolver, EnvironmentStoreConfig } from './infrastructure/environment/environment-resolver';
 import { ForgeEnv } from './infrastructure/environment/forge-env';
-import { IVariableInterpolator } from './types/environment-config';
 import { RequestExecutor } from './infrastructure/execution/request-executor';
 import { IRequestHistory } from './infrastructure/history/history-interfaces';
 import { IErrorInterceptor, IInterceptorChain, IRequestInterceptor, IResponseInterceptor } from './infrastructure/http/interceptor-chain';
 import { IRequestPreprocessor } from './infrastructure/http/request-preprocessor';
 import { IDataFileParser } from './infrastructure/platform/data-file-parser';
 import { IScriptExecutor } from './infrastructure/script/interfaces';
+import { IVariableInterpolator } from './types/environment-config';
 import { IFileSystem, IHttpClient } from './types/platform';
 import { HttpRequest, HttpResponse, RequestSettings, UnifiedCollection, UnifiedRequest } from './types/types';
 /**
@@ -71,6 +71,11 @@ export interface ForgeContainerOptions {
     scriptExecutor?: IScriptExecutor;
     /** Script execution timeout (ms) */
     scriptTimeout?: number;
+    /**
+     * Script scope mode. 'shared' (default) runs all script levels in one scope;
+     * 'isolated' runs each level in its own scope for Postman compatibility.
+     */
+    scriptScope?: 'shared' | 'isolated';
     /** Custom file system implementation */
     fileSystem?: IFileSystem;
     /** Custom variable interpolator implementation */