@http-forge/core 0.4.3 → 0.4.5

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
@@ -549,6 +564,14 @@ Detects Postman format by `info._postman_id` and converts all five body modes:
 
 Auth types `bearer`, `basic`, and `apikey` are converted. Pre-request and test scripts (`prerequest`/`test` events) are imported as `scripts.preRequest`/`scripts.postResponse`. Folder hierarchy and item order are preserved.
 
+The whole collection is built in memory and persisted with a single `saveCollection()`
+call. `FolderCollectionStore.save()` writes sibling items and each request's
+independent files (body, docs, scripts, schemas) in parallel and writes each
+metadata file once; fresh imports skip stale-body cleanup and schema-existence
+probes. Loaders read JSON via a `readJsonFileSafe` helper that silently skips
+empty or half-written files, so a watcher reloading mid-import never throws
+`Unexpected end of JSON input`.
+
 **Export** (`exportCollection(collectionId, filePath)`):
 
 Converts back to Postman v2.1 JSON. All body types round-trip correctly: `x-www-form-urlencoded` exports as `mode: "urlencoded"`, `form-data` as `mode: "formdata"`, `graphql` as `mode: "graphql"`, and `binary` as `mode: "binary"`.

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 */